​

nodes/troubleshooting.md

​

سلّم الأوامر

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>

• العُقدة متصلة ومقترنة للدور node.
• nodes describe يتضمن الإمكانية التي تستدعيها.
• تُظهر موافقات التنفيذ الوضع/قائمة السماح المتوقعة.

​

متطلبات المقدّمة

openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow

​

مصفوفة الأذونات

​

الإقران مقابل الموافقات

1. إقران الجهاز: هل يمكن لهذه العُقدة الاتصال بـ Gateway (البوابة)؟
2. موافقات التنفيذ: هل يمكن لهذه العُقدة تشغيل أمر صدفة محدد؟

openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

​

رموز أخطاء العُقدة الشائعة

• NODE_BACKGROUND_UNAVAILABLE → التطبيق في الخلفية؛ اجعله في المقدّمة.
• CAMERA_DISABLED → تعطيل مفتاح الكاميرا في إعدادات العُقدة.
• *_PERMISSION_REQUIRED → إذن نظام التشغيل مفقود/مرفوض.
• LOCATION_DISABLED → وضع الموقع متوقف.
• LOCATION_PERMISSION_REQUIRED → لم يتم منح وضع الموقع المطلوب.
• LOCATION_BACKGROUND_UNAVAILABLE → التطبيق في الخلفية لكن يوجد إذن «أثناء الاستخدام» فقط.
• SYSTEM_RUN_DENIED: approval required → طلب التنفيذ يحتاج موافقة صريحة.
• SYSTEM_RUN_DENIED: allowlist miss → الأمر محظور بواسطة وضع قائمة السماح.

​

حلقة استعادة سريعة

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow

• إعادة الموافقة على إقران الجهاز.
• إعادة فتح تطبيق العُقدة (في المقدّمة).
• إعادة منح أذونات نظام التشغيل.
• إعادة إنشاء/تعديل سياسة موافقات التنفيذ.

• /nodes/index
• /nodes/camera
• /nodes/location-command
• /tools/exec-approvals
• /gateway/pairing