Skip to main content

​
openclaw qr

أنشئ رمز QR للاقتران على الهاتف المحمول ورمز إعداد من تكوين Gateway الحالي.
تتصل تطبيقات OpenClaw الرسمية لنظامي iOS وAndroid تلقائيًا عندما تتطابق بيانات تعريف رمز الإعداد الخاصة بها. إذا ظل طلب معلقًا (على سبيل المثال، لعميل غير رسمي أو بسبب عدم تطابق بيانات التعريف)، فراجعه ووافق عليه:

​
الخيارات

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

​
محتويات رمز الإعداد

يحمل رمز الإعداد bootstrapToken مبهمًا وقصير الأجل، وليس رمز Gateway المشترك أو كلمة مروره. بالنسبة إلى نقطة نهاية wss:// (أو الاسترجاع الحلقي على المضيف نفسه)، يُصدر تدفق التمهيد الافتراضي:
  • رمز node أساسيًا مع scopes: []
  • رمز تسليم operator كاملاً وأصليًا للهاتف المحمول مع operator.admin وoperator.approvals وoperator.read وoperator.talk.secrets وoperator.write
استخدم --limited للاحتفاظ برمز Node نفسه مع حذف operator.admin من تسليم المشغّل. لا يُسلَّم نطاق تعديل الاقتران مطلقًا بواسطة رمز إعداد. يظل إعداد ws:// عبر شبكة LAN بنص صريح متاحًا، لكن OpenClaw يستخدم ملف التعريف المحدود تلقائيًا لأن مراقبًا للشبكة قد يلتقط رمز التمهيد من نوع bearer ويسابق استخدامه. هيّئ wss:// أو Tailscale Serve، ثم أنشئ رمزًا جديدًا للحصول على وصول كامل.

​
تحليل عنوان URL الخاص بـ Gateway

يفشل اقتران الهاتف المحمول بصورة مغلقة مع عناوين URL الخاصة بـ Gateway من النوع Tailscale/العام ws://: استخدم Tailscale Serve/Funnel أو عنوان URL ‏wss:// لـ Gateway في هذه الحالات. تظل عناوين شبكة LAN الخاصة ومضيفات Bonjour من النوع .local مدعومة عبر ws:// الصريح، مع وصول محدود للمشغّل كما هو موضح أعلاه. عندما يأتي عنوان URL المحدد لـ Gateway من gateway.bind=lan، يتحقق OpenClaw أيضًا من مسارات tailscale serve status --json الدائمة. يُضمَّن كمسار احتياطي أي جذر HTTPS Serve يمرر طلبات منفذ الاسترجاع الحلقي لـ Gateway النشط. يضيف أمر QR هذا المسار الاحتياطي إلى lan فقط؛ ويحتفظ custom وtailnet بالمسارات المعلنة صراحةً. تختبر عملاء iOS الحالية المسارات المعلنة بالترتيب وتحفظ أول مسار يمكن الوصول إليه؛ ويظل الحقل القديم url دون تغيير للعملاء الأقدم. عند استخدام --remote، يلزم أحد الخيارين gateway.remote.url أو gateway.tailscale.mode=serve|funnel.

​
تحليل المصادقة (من دون --remote)

عند عدم تمرير تجاوز للمصادقة عبر CLI، تُحل مراجع الأسرار SecretRefs الخاصة بمصادقة Gateway المحلي كما يلي:

​
تحليل المصادقة (--remote)

إذا كانت بيانات الاعتماد البعيدة النشطة فعليًا مهيأة بوصفها SecretRefs ولم يُمرَّر أي من --token أو --password، فسيحلها الأمر من لقطة Gateway النشطة. إذا لم يكن Gateway متاحًا، يفشل الأمر فورًا.
يتطلب مسار هذا الأمر Gateway يدعم طريقة RPC المسماة secrets.resolve. تُرجع بوابات Gateway الأقدم خطأً يفيد بأن الطريقة غير معروفة.

​
ذو صلة