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

​
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 يتضمن الإمكانية التي تستدعيها.
  • تُظهر موافقات التنفيذ الوضع/قائمة السماح المتوقعة.

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

canvas.* وcamera.* وscreen.* تعمل في المقدّمة فقط على عُقد iOS/Android. فحص سريع وإصلاح: 
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
إذا رأيت NODE_BACKGROUND_UNAVAILABLE، فاجعل تطبيق العُقدة في المقدّمة ثم أعد المحاولة.

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

الإمكانيةiOSAndroidتطبيق العُقدة على macOSرمز الفشل النموذجي
camera.snap، camera.clipالكاميرا (+ الميكروفون لصوت المقطع)الكاميرا (+ الميكروفون لصوت المقطع)الكاميرا (+ الميكروفون لصوت المقطع)*_PERMISSION_REQUIRED
screen.recordتسجيل الشاشة (+ الميكروفون اختياري)مطالبة التقاط الشاشة (+ الميكروفون اختياري)تسجيل الشاشة*_PERMISSION_REQUIRED
location.getأثناء الاستخدام أو دائمًا (يعتمد على الوضع)الموقع في المقدّمة/الخلفية بحسب الوضعإذن الموقعLOCATION_PERMISSION_REQUIRED
system.runn/a (مسار مضيف العقدة)n/a (مسار مضيف العقدة)تتطلب موافقات التنفيذSYSTEM_RUN_DENIED

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

هذه بوابتان مختلفتان:
  1. إقران الجهاز: هل يمكن لهذه العُقدة الاتصال بـ Gateway (البوابة)؟
  2. موافقات التنفيذ: هل يمكن لهذه العُقدة تشغيل أمر صدفة محدد؟
فحوصات سريعة: 
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
إذا كان الإقران مفقودًا، فوافق على جهاز العُقدة أولًا. إذا كان الإقران سليمًا لكن system.run يفشل، فأصلح موافقات التنفيذ/قائمة السماح.

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

  • 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
إذا استمر التعطّل:
  • إعادة الموافقة على إقران الجهاز.
  • إعادة فتح تطبيق العُقدة (في المقدّمة).
  • إعادة منح أذونات نظام التشغيل.
  • إعادة إنشاء/تعديل سياسة موافقات التنفيذ.
ذو صلة: