openclaw nodes

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

ذات صلة:

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

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

• --url، --token، --timeout، --json

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

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

يطبع nodes list جداول الطلبات المعلقة/المقترنة. تتضمن الصفوف المقترنة عمر أحدث اتصال (آخر اتصال). استخدم --connected لعرض العُقد المتصلة حاليًا فقط. استخدم --last-connected <duration> من أجل التصفية إلى العُقد التي اتصلت ضمن مدة زمنية (مثل 24h، 7d). استخدم nodes remove --node <id|name|ip> لإزالة اقتران عقدة. بالنسبة إلى عقدة مدعومة بجهاز، يؤدي ذلك إلى إبطال دور node الخاص بالجهاز في devices/paired.json وقطع جلساته ذات دور العقدة (يحتفظ الجهاز متعدد الأدوار بصفه ويفقد دور node فقط؛ أما الجهاز ذو دور العقدة فقط فيُحذف)؛ كما يمسح أي سجل اقتران عقدة قديم مطابق مملوك من Gateway. يستطيع operator.pairing إزالة صفوف العُقد غير الخاصة بالمشغّل؛ ويحتاج مستدعي رمز الجهاز الذي يبطل دور العقدة الخاص به على جهاز متعدد الأدوار إلى operator.admin أيضًا.

ملاحظة الموافقة:

• لا يحتاج openclaw nodes pending إلا إلى نطاق الاقتران.
• يمكن لـ gateway.nodes.pairing.autoApproveCidrs تخطي خطوة الانتظار فقط لأجل اقتران جهاز role: node موثوق صراحةً ولأول مرة. يكون ذلك متوقفًا افتراضيًا ولا يوافق على الترقيات.
• يرث openclaw nodes approve <requestId> متطلبات نطاق إضافية من الطلب المعلّق:
  • طلب بلا أوامر: الاقتران فقط
  • أوامر العُقد غير التنفيذية: الاقتران + الكتابة
  • system.run / system.run.prepare / system.which: الاقتران + الإدارة

الاستدعاء

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

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

• --params <json>: سلسلة كائن JSON (الافتراضي {}).
• --invoke-timeout <ms>: مهلة استدعاء العقدة (الافتراضي 15000).
• --idempotency-key <key>: مفتاح اختيارية لضمان التكرارية الآمنة.
• system.run وsystem.run.prepare محظوران هنا؛ استخدم أداة exec مع host=node لتنفيذ الصدفة.

لتنفيذ الصدفة على عقدة، استخدم أداة exec مع host=node بدلًا من openclaw nodes run. أصبحت CLI الخاصة بـ nodes تركز الآن على القدرات: RPC مباشر عبر nodes invoke، إضافةً إلى الاقتران والكاميرا والشاشة والموقع وCanvas والإشعارات. تُنفّذ أوامر Canvas بواسطة Plugin Canvas التجريبي المضمّن؛ ويحتفظ النواة بخطاف توافق بحيث تبقى ضمن openclaw nodes canvas.

ذات صلة

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