openclaw qr

أنشئ رمز QR لإقران الهاتف ورمز إعداد من تهيئة Gateway الحالية لديك.

الاستخدام

openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws

الخيارات

• --remote: يفضّل gateway.remote.url؛ إذا لم يكن معيّناً، فيمكن لـ gateway.tailscale.mode=serve|funnel أن يوفّر عنوان URL العام البعيد أيضاً
• --url <url>: تجاوز عنوان URL الخاص بـ gateway المستخدم في الحمولة
• --public-url <url>: تجاوز عنوان URL العام المستخدم في الحمولة
• --token <token>: تجاوز رمز gateway الذي يتوثق تدفق التمهيد مقابله
• --password <password>: تجاوز كلمة مرور gateway التي يتوثق تدفق التمهيد مقابلها
• --setup-code-only: اطبع رمز الإعداد فقط
• --no-ascii: تخطَّ عرض QR بصيغة ASCII
• --json: أخرج JSON (setupCode, gatewayUrl, auth, urlSource)

ملاحظات

• الخياران --token و--password متنافيان.
• يحمل رمز الإعداد نفسه الآن bootstrapToken معتماً وقصير العمر، وليس رمز gateway/كلمة المرور المشتركة.
• يعيد تمهيد رمز الإعداد المضمّن رمز node أساسياً مع scopes: [] بالإضافة إلى رمز تسليم operator محدود للإعداد الموثوق للهاتف.
• يقتصر رمز المشغّل المسلَّم على operator.approvals وoperator.read وoperator.talk.secrets وoperator.write؛ ولا تزال نطاقات تعديل الإقران وoperator.admin تتطلب إقران مشغّل منفصلاً ومعتمداً أو تدفق رمز.
• يفشل إقران الهاتف بشكل مغلق لعناوين URL الخاصة بـ gateway بصيغة ws:// عبر Tailscale/العامة. تظل عناوين LAN الخاصة ومضيفو Bonjour بصيغة .local مدعومة عبر ws://، لكن يجب أن تستخدم مسارات الهاتف عبر Tailscale/العامة Tailscale Serve/Funnel أو عنوان URL لـ gateway بصيغة wss://.
• مع --remote، يتطلب OpenClaw إما gateway.remote.url أو gateway.tailscale.mode=serve|funnel.
• مع --remote، إذا كانت بيانات اعتماد البعيد الفعالة والنشطة مهيأة كـ SecretRefs ولم تمرر --token أو --password، يحلّها الأمر من لقطة gateway النشطة. إذا كان gateway غير متاح، يفشل الأمر سريعاً.
• بدون --remote، تُحل SecretRefs الخاصة بمصادقة gateway المحلي عند عدم تمرير تجاوز مصادقة عبر CLI:
  • يُحل gateway.auth.token عندما يمكن لمصادقة الرمز أن تفوز (gateway.auth.mode="token" الصريح أو الوضع المستنتج حيث لا يفوز أي مصدر كلمة مرور).
  • يُحل gateway.auth.password عندما يمكن لمصادقة كلمة المرور أن تفوز (gateway.auth.mode="password" الصريح أو الوضع المستنتج من دون رمز فائز من المصادقة/البيئة).
• إذا كان كل من gateway.auth.token وgateway.auth.password مهيأين (بما في ذلك SecretRefs) وكان gateway.auth.mode غير معيّن، يفشل حل رمز الإعداد حتى يتم تعيين الوضع صراحةً.
• ملاحظة حول اختلاف إصدار Gateway: يتطلب مسار هذا الأمر gateway يدعم secrets.resolve؛ تعيد الإصدارات الأقدم من gateway خطأ طريقة غير معروفة.
• تتصل تطبيقات OpenClaw الرسمية على iOS وAndroid تلقائياً عندما تتطابق بيانات تعريف رمز الإعداد لديها. إذا ظل الطلب معلقاً (مثلاً، لعميل غير رسمي أو بيانات تعريف غير متطابقة)، فراجعه ووافق عليه باستخدام:
  • openclaw devices list
  • openclaw devices approve <requestId>

ذو صلة

• مرجع CLI
• الإقران