nodes

إدارة العقد (الأجهزة) المقترنة واستدعاء قدرات العقد. ذات صلة:

• نظرة عامة على العقد: العقد
• الكاميرا: عقد الكاميرا
• الصور: عقد الصور

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

• --url, --token, --timeout, --json

الأوامر الشائعة

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list تطبع جداول العقد المعلقة/المقترنة. تتضمن صفوف العقد المقترنة عمر آخر اتصال (Last Connect). استخدم --connected لعرض العقد المتصلة حالياً فقط. استخدم --last-connected <duration> لتصفية العقد التي اتصلت خلال مدة زمنية (مثال: 24h, 7d).

استدعاء / تشغيل

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
openclaw nodes run --node <id|name|ip> <command...>
openclaw nodes run --raw "git status"
openclaw nodes run --agent main --node <id|name|ip> --raw "git status"

أعلام الاستدعاء:

• --params <json>: سلسلة كائن JSON (الافتراضي {}).
• --invoke-timeout <ms>: مهلة استدعاء العقدة (الافتراضي 15000).
• --idempotency-key <key>: مفتاح عدم التكرار اختياري.

الإعدادات الافتراضية على نمط التنفيذ

nodes run تعكس سلوك exec للنموذج (الإعدادات الافتراضية + الموافقات):

• تقرأ tools.exec.* (بالإضافة إلى تجاوزات agents.list[].tools.exec.*).
• تستخدم موافقات exec (exec.approval.request) قبل استدعاء system.run.
• يمكن حذف --node عندما يكون tools.exec.node مضبوطاً.
• تتطلب عقدة تعلن عن system.run (تطبيق Companion لنظام macOS أو مضيف عقدة headless).

الأعلام:

• --cwd <path>: دليل العمل.
• --env <key=val>: تجاوز متغير البيئة (قابل للتكرار). ملاحظة: مضيفو العقد يتجاهلون تجاوزات PATH (ولا يتم تطبيق tools.exec.pathPrepend على مضيفي العقد).
• --command-timeout <ms>: مهلة الأمر.
• --invoke-timeout <ms>: مهلة استدعاء العقدة (الافتراضي 30000).
• --needs-screen-recording: تتطلب إذن تسجيل الشاشة.
• --raw <command>: تشغيل سلسلة shell (/bin/sh -lc أو cmd.exe /c). في وضع القائمة المسموحة على مضيفي عقد Windows، يتطلب تشغيل غلاف shell cmd.exe /c موافقة (الإدخال في القائمة المسموحة وحده لا يسمح تلقائياً بصيغة الغلاف).
• --agent <id>: موافقات/قوائم مسموحة محددة بالوكيل (الافتراضي هو الوكيل المضبوط).
• --ask <off|on-miss|always>, --security <deny|allowlist|full>: تجاوزات.

nodeonboard