تسلسل الأوامر
- تكون Node متصلة ومقترنة للدور
node. - يتضمن
nodes describeالإمكانية التي تستدعيها. - تعرض موافقات التنفيذ الوضع/قائمة السماح المتوقعة.
متطلبات التشغيل في الواجهة
لا تعملcanvas.* وcamera.* وscreen.* إلا عندما يكون التطبيق في الواجهة على عُقد iOS/Android.
تحقق وإصلاح سريعان:
NODE_BACKGROUND_UNAVAILABLE، فانقل تطبيق Node إلى الواجهة وأعد المحاولة.
مصفوفة الأذونات
الاقتران مقابل الموافقات
تتحكم ثلاث بوابات منفصلة في نجاح أمر Node:- اقتران الجهاز: هل يمكن لهذه Node الاتصال بـ Gateway؟
- سياسة أوامر Node في Gateway: هل معرّف أمر RPC مسموح به وفق
gateway.nodes.allowCommands/denyCommandsوالإعدادات الافتراضية للمنصة؟ - موافقات التنفيذ: هل يمكن لهذه Node تشغيل أمر shell محدد محليًا؟
system.run، توجد السياسة الخاصة بكل Node في ملف موافقات التنفيذ لتلك Node (openclaw approvals get --node ...)، وليس في سجل الاقتران في Gateway.
عمليات تحقق سريعة:
- الاقتران مفقود: وافق على جهاز Node أولًا.
- يفتقد
nodes describeأمرًا: تحقق من سياسة أوامر Node في Gateway ومن أن Node أعلنت فعلًا عن ذلك الأمر عند الاتصال. - الاقتران سليم لكن
system.runيفشل: أصلح موافقات التنفيذ/قائمة السماح على تلك Node.
host=node المدعومة بالموافقة، يربط Gateway أيضًا التنفيذ بـ systemRunPlan الأساسي المُعَدّ. إذا عدّل مستدعٍ لاحق الأمر أو دليل العمل الحالي أو بيانات الجلسة الوصفية قبل تمرير التشغيل الموافق عليه، يرفض Gateway التشغيل باعتباره عدم تطابق في الموافقة بدلًا من الوثوق بالحمولة المعدّلة.
رموز أخطاء Node الشائعة
حلقة الاسترداد السريع
- أعد الموافقة على اقتران الجهاز.
- أعد فتح تطبيق Node (في الواجهة).
- أعد منح أذونات نظام التشغيل.
- أعد إنشاء سياسة موافقة التنفيذ أو عدّلها.
computer، وأن screen.snapshot ينجح مع إذن تسجيل الشاشة، وأن /phone status يعرض تخويل Gateway المؤقت أو الدائم الذي قصدته. يتجاوز إدخال gateway.nodes.denyCommands دائمًا allowCommands.