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 devices
إدارة طلبات إقران الأجهزة والرموز المميزة ذات النطاق الخاص بالجهاز.
الأوامر
openclaw devices list
اعرض طلبات الإقران المعلّقة والأجهزة المقترنة.
openclaw devices remove <deviceId>
أزِل إدخال جهاز مقترن واحد.
عندما تكون مصادقًا باستخدام رمز جهاز مقترن، يمكن للمتصلين غير المسؤولين إزالة إدخال جهازهم الخاص فقط. تتطلب إزالة جهاز آخر operator.admin.
openclaw devices clear --yes [--pending]
امسح الأجهزة المقترنة دفعة واحدة.
openclaw devices approve [requestId] [--latest]
وافِق على طلب إقران جهاز معلّق باستخدام requestId الدقيق. إذا أُغفل requestId أو مُرر --latest، فإن OpenClaw يطبع فقط الطلب المعلّق المحدد ويخرج؛ أعِد تشغيل الموافقة باستخدام معرّف الطلب الدقيق بعد التحقق من التفاصيل.
إذا أعاد جهاز محاولة الإقران مع تفاصيل مصادقة متغيرة (الدور أو النطاقات أو المفتاح العام)، فإن OpenClaw يستبدل الإدخال المعلّق السابق ويصدر
requestId جديدًا. شغّل openclaw devices list قبل الموافقة مباشرة لاستخدام المعرّف الحالي.Requested مقابل Approved في openclaw devices list أو استخدم openclaw devices approve --latest لمعاينة الترقية الدقيقة قبل الموافقة عليها.
إذا كان Gateway مهيأً صراحةً باستخدام gateway.nodes.pairing.autoApproveCidrs، فيمكن الموافقة على طلبات role: node لأول مرة من عناوين IP العملاء المطابقة قبل ظهورها في هذه القائمة. تكون هذه السياسة معطلة افتراضيًا ولا تنطبق أبدًا على عملاء المشغّل/المتصفح أو طلبات الترقية.
openclaw devices reject <requestId>
ارفض طلب إقران جهاز معلّق.
openclaw devices rotate --device <id> --role <role> [--scope <scope...>]
بدّل رمز جهاز مميزًا لدور محدد (مع تحديث النطاقات اختياريًا).
يجب أن يكون الدور الهدف موجودًا بالفعل في عقد الإقران المعتمد لذلك الجهاز؛ لا يمكن للتبديل إصدار دور جديد غير معتمد.
إذا أغفلت --scope، فإن عمليات إعادة الاتصال اللاحقة باستخدام الرمز المبدّل المخزن تعيد استخدام النطاقات المعتمدة المخزنة مؤقتًا لذلك الرمز. إذا مررت قيم --scope صريحة، فتصبح هذه مجموعة النطاقات المخزنة لعمليات إعادة الاتصال المستقبلية باستخدام الرمز المخزن مؤقتًا.
يمكن للمتصلين غير المسؤولين عبر الأجهزة المقترنة تبديل رمز جهازهم الخاص فقط.
يجب أن تبقى مجموعة نطاقات الرمز الهدف ضمن نطاقات المشغّل الخاصة بجلسة المتصل؛ لا يمكن للتبديل إصدار رمز مشغّل أوسع أو الحفاظ عليه مما لدى المتصل بالفعل.
openclaw devices revoke --device <id> --role <role>
أبطِل رمز جهاز مميزًا لدور محدد.
يمكن للمتصلين غير المسؤولين عبر الأجهزة المقترنة إبطال رمز جهازهم الخاص فقط.
يتطلب إبطال رمز جهاز آخر operator.admin.
يجب أن تلائم مجموعة نطاقات الرمز الهدف أيضًا نطاقات المشغّل الخاصة بجلسة المتصل؛ لا يمكن للمتصلين المخصصين للإقران فقط إبطال رموز المشغّل المسؤولة/ذات الكتابة.
الخيارات الشائعة
--url <url>: عنوان URL لـ WebSocket الخاص بـ Gateway (يستخدمgateway.remote.urlافتراضيًا عند تهيئته).--token <token>: رمز Gateway المميز (إذا كان مطلوبًا).--password <password>: كلمة مرور Gateway (مصادقة كلمة المرور).--timeout <ms>: مهلة RPC.--json: خرج JSON (موصى به للبرمجة النصية).
ملاحظات
- يعيد تبديل الرمز المميز رمزًا مميزًا جديدًا (حساسًا). عامله كسر.
- تتطلب هذه الأوامر نطاق
operator.pairing(أوoperator.admin). تتطلب بعض الموافقات أيضًا أن يحتفظ المتصل بنطاقات المشغّل التي سيصدرها الجهاز الهدف أو يرثها؛ راجع نطاقات المشغّل. gateway.nodes.pairing.autoApproveCidrsهي سياسة Gateway اختيارية لإقران أجهزة node الجديدة فقط؛ ولا تغير صلاحية موافقة CLI.- يبقى تبديل الرموز المميزة وإبطالها داخل مجموعة أدوار الإقران المعتمدة وخط أساس النطاق المعتمد لذلك الجهاز. لا يمنح إدخال رمز مخزن مؤقتًا شارد هدفًا لإدارة الرموز المميزة.
- بالنسبة إلى جلسات رموز الأجهزة المقترنة، تكون الإدارة عبر الأجهزة للمسؤول فقط:
removeوrotateوrevokeذاتية فقط ما لم يكن لدى المتصلoperator.admin. - يُحتوى تغيير الرمز المميز أيضًا ضمن نطاق المتصل: لا يمكن لجلسة مخصصة للإقران فقط تبديل أو إبطال رمز يحمل حاليًا
operator.adminأوoperator.write. devices clearمحمي عمدًا بواسطة--yes.- إذا كان نطاق الإقران غير متاح على local loopback (ولم يُمرر
--urlصريح)، فيمكن أن يستخدم العرض/الموافقة بديل إقران محليًا. - يتطلب
devices approveمعرّف طلب صريحًا قبل إصدار الرموز المميزة؛ إغفالrequestIdأو تمرير--latestيعاين فقط أحدث طلب معلّق.
قائمة التحقق لاسترداد انجراف الرمز المميز
استخدم هذا عندما تستمر واجهة Control UI أو العملاء الآخرون في الفشل معAUTH_TOKEN_MISMATCH أو AUTH_DEVICE_TOKEN_MISMATCH أو AUTH_SCOPE_MISMATCH.
- أكّد مصدر رمز Gateway المميز الحالي:
- اعرض الأجهزة المقترنة وحدد معرّف الجهاز المتأثر:
- بدّل رمز المشغّل المميز للجهاز المتأثر:
- إذا لم يكن التبديل كافيًا، فأزِل الإقران القديم ووافِق مرة أخرى:
- أعِد محاولة اتصال العميل باستخدام الرمز/كلمة المرور المشتركة الحالية.
- أسبقية مصادقة إعادة الاتصال العادية هي الرمز/كلمة المرور المشتركة الصريحة أولًا، ثم
deviceTokenالصريح، ثم رمز الجهاز المخزن، ثم رمز bootstrap. - يمكن لاسترداد
AUTH_TOKEN_MISMATCHالموثوق إرسال كل من الرمز المشترك ورمز الجهاز المخزن معًا مؤقتًا للمحاولة الواحدة المحدودة. - يعني
AUTH_SCOPE_MISMATCHأن رمز الجهاز تم التعرف عليه لكنه لا يحمل مجموعة النطاقات المطلوبة؛ أصلح عقد موافقة الإقران/النطاق قبل تغيير مصادقة Gateway المشتركة.