الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw qr

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

​
الاستخدام

openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw 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 المشتركة.
  • في تدفق تمهيد العقدة/المشغّل المضمّن، لا يزال رمز العقدة الأساسي يصل مع scopes: [].
  • إذا أصدر تسليم التمهيد أيضًا رمز مشغّل، فإنه يظل مقيّدًا بقائمة السماح الخاصة بالتمهيد: operator.approvals, operator.read, operator.talk.secrets, operator.write.
  • فحوصات نطاق التمهيد مسبوقة بالدور. قائمة سماح المشغّل هذه تلبّي طلبات المشغّل فقط؛ ولا تزال الأدوار غير المشغّلة تحتاج إلى نطاقات تحت بادئة دورها الخاصة.
  • يفشل إقران الهاتف المحمول بإغلاق آمن لعناوين Gateway الخاصة بـ Tailscale/العامة من نوع ws://. تظل عناوين LAN الخاصة ومضيفو Bonjour ذوو اللاحقة .local مدعومة عبر ws://، لكن مسارات الهاتف المحمول عبر Tailscale/العامة يجب أن تستخدم Tailscale Serve/Funnel أو عنوان 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 devices list
    • openclaw devices approve <requestId>

​
ذو صلة