​

openclaw devices

​

الخيارات الشائعة

• --url <url>: عنوان URL لاتصال WebSocket الخاص بـ Gateway (القيمة الافتراضية هي gateway.remote.url عند تهيئته)
• --token <token>: الرمز المميز لـ Gateway (إذا كان مطلوبًا)
• --password <password>: كلمة مرور Gateway (مصادقة بكلمة المرور)
• --timeout <ms>: مهلة RPC
• --json: إخراج JSON (موصى به للبرمجة النصية)

​

الأوامر

​

openclaw devices list

openclaw devices list
openclaw devices list --json

​

openclaw devices approve [requestId] [--latest]

openclaw devices approve
openclaw devices approve <requestId>
openclaw devices approve --latest

• إذا كان الجهاز مقترنًا بالفعل وطلب نطاقات أوسع أو دورًا آخر، يحتفظ OpenClaw بالموافقة الحالية وينشئ طلب ترقية معلّقًا جديدًا. قارن Requested بـ Approved في openclaw devices list، أو عاين الطلب باستخدام --latest، قبل الموافقة.
• تتطلب الموافقة على دور node أو أي دور آخر غير المشغّل النطاق operator.admin. يكفي operator.pairing للموافقة على أجهزة المشغّلين، ولكن فقط عندما تبقى نطاقات المشغّل المطلوبة ضمن نطاقات المستدعي نفسه. راجع نطاقات المشغّل.
• إذا تمت تهيئة gateway.nodes.pairing.autoApproveCidrs، فقد تتم الموافقة تلقائيًا على طلبات role: node لأول مرة الواردة من عناوين IP للعملاء المطابقة قبل ظهورها في هذه القائمة. تكون هذه الميزة معطّلة افتراضيًا، ولا تنطبق مطلقًا على عملاء المشغّل أو المتصفح أو طلبات الترقية.
• يوافق gateway.nodes.pairing.sshVerify (المفعّل افتراضيًا) تلقائيًا على طلبات role: node لأول مرة عندما يتحقق Gateway من مفتاح الجهاز عبر SSH إلى مضيف Node. لذلك قد تتحول الطلبات إلى حالة الموافقة بعد وقت قصير من ظهورها. عيّن sshVerify: false لتعطيل التحقق عبر SSH؛ وهذا مستقل عن autoApproveCidrs، لذا ألغِ تعيينه أيضًا لفرض الإقران اليدوي فقط.

​

openclaw devices reject <requestId>

openclaw devices reject <requestId>

​

openclaw devices remove <deviceId>

openclaw devices remove <deviceId>
openclaw devices remove <deviceId> --json

​

openclaw devices rename --device <id> --name <label>

openclaw devices rename --device <deviceId> --name "Kitchen Mac"
openclaw devices rename --device <deviceId> --name "Kitchen Mac" --json

• الخيار --name مطلوب، وتُزال المسافات المحيطة بقيمته، ويجب ألا يكون فارغًا، ويقتصر على 64 محرفًا.
• تفضّل واجهات العرض (قائمة CLI، وقائمة أجهزة واجهة التحكم) تسمية المشغّل على اسم العرض الذي يبلّغ عنه العميل.
• يمكن لمستدعٍ غير إداري يستخدم جهازًا مقترنًا إعادة تسمية جهازه الخاص فقط. تتطلب إعادة تسمية جهاز آخر النطاق operator.admin.

​

openclaw devices clear --yes [--pending]

openclaw devices clear --yes
openclaw devices clear --yes --pending
openclaw devices clear --yes --pending --json

​

openclaw devices rotate --device <id> --role <role> [--scope <scope...>]

openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

• يجب أن يكون الدور المستهدف موجودًا بالفعل في عقد الإقران المعتمد لذلك الجهاز؛ لا يمكن للتدوير إصدار دور جديد غير معتمد.
• يؤدي حذف --scope إلى إعادة استخدام النطاقات المعتمدة المخزنة مؤقتًا للرمز المميز المخزّن عند عمليات إعادة الاتصال اللاحقة. يؤدي تمرير قيم --scope صريحة إلى استبدال مجموعة النطاقات المخزنة لعمليات إعادة الاتصال المستقبلية باستخدام الرمز المميز المخزّن مؤقتًا.
• يمكن لمستدعٍ غير إداري يستخدم جهازًا مقترنًا تدوير الرمز المميز لجهازه الخاص فقط، ويجب أن تبقى مجموعة النطاقات المستهدفة ضمن نطاقات المشغّل الخاصة بالمستدعي؛ ولا يمكن للتدوير إصدار رمز مميز أوسع مما يملكه المستدعي بالفعل أو الاحتفاظ به.

​

openclaw devices revoke --device <id> --role <role>

openclaw devices revoke --device <deviceId> --role node

​

ملاحظات

• تتطلب هذه الأوامر النطاق operator.pairing (أو operator.admin). تتطلب أدوار الأجهزة غير المشغّلة دائمًا operator.admin؛ راجع نطاقات المشغّل.
• يظل تدوير الرموز المميزة وإبطالها ضمن مجموعة أدوار الإقران المعتمدة للجهاز وخط أساس النطاقات. لا يمنح إدخال رمز مميز متروك في ذاكرة التخزين المؤقت هدفًا لإدارة الرموز المميزة.
• بالنسبة إلى جلسات الرموز المميزة للأجهزة المقترنة، تقتصر إدارة الأجهزة الأخرى (remove وrename وrotate وrevoke) على الجهاز نفسه ما لم يكن المستدعي يملك operator.admin.
• يُرجع تدوير الرمز المميز رمزًا جديدًا (حساسًا) — عامله بوصفه سرًا.
• إذا لم يكن نطاق الإقران متاحًا عبر local loopback ولم يُمرّر --url صراحةً، فيمكن للأمرين list وapprove الرجوع إلى حالة الإقران المحلية.

​

قائمة التحقق لاسترداد انحراف الرمز المميز

1. تأكّد من المصدر الحالي للرمز المميز الخاص بـ Gateway:
   openclaw config get gateway.auth.token
   
2. اعرض الأجهزة المقترنة وحدّد معرّف الجهاز المتأثر:
   openclaw devices list
   
3. دوّر رمز المشغّل للجهاز المتأثر:
   openclaw devices rotate --device <deviceId> --role operator
   
4. إذا لم يكن التدوير كافيًا، فأزل الإقران القديم ووافق عليه مجددًا:
   openclaw devices remove <deviceId>
   openclaw devices list
   openclaw devices approve <requestId>
   
5. أعد محاولة اتصال العميل باستخدام الرمز المميز المشترك الحالي أو كلمة المرور الحالية.

• ترتيب أولوية المصادقة المعتاد عند إعادة الاتصال: الرمز المميز المشترك أو كلمة المرور الصريحان أولًا، ثم deviceToken الصريح، ثم رمز الجهاز المخزّن، ثم رمز التمهيد.
• يمكن لاسترداد AUTH_TOKEN_MISMATCH الموثوق أن يرسل مؤقتًا الرمز المميز المشترك ورمز الجهاز المخزّن معًا لمحاولة إعادة واحدة محدودة.
• يعني AUTH_SCOPE_MISMATCH أن رمز الجهاز قد تم التعرّف عليه، لكنه لا يحمل مجموعة النطاقات المطلوبة؛ أصلح عقد الموافقة على الإقران والنطاقات قبل تغيير مصادقة Gateway المشتركة.

• استكشاف أخطاء مصادقة لوحة المعلومات وإصلاحها
• استكشاف أخطاء Gateway وإصلاحها

​

موافقة التشغيل الأول لـ Paperclip / openclaw_gateway

openclaw devices approve --latest

openclaw devices approve --latest --url <gateway-ws-url> --token <gateway-token>

{
  "adapterConfig": {
    "devicePrivateKeyPem": "<ed25519-private-key-pkcs8-pem>"
  }
}

​

ذو صلة

• مرجع CLI
• العُقد