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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

openclaw 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 reject <requestId>
openclaw nodes remove --node <id|name|ip>
openclaw nodes rename --node <id|name|ip> --name <displayName>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
يطبع nodes list جداول الطلبات المعلّقة/المقترنة. تتضمن الصفوف المقترنة عمر أحدث اتصال (آخر اتصال). استخدم --connected لعرض العُقد المتصلة حاليًا فقط. استخدم --last-connected <duration> من أجل التصفية إلى العُقد التي اتصلت ضمن مدة محددة (مثل 24h، 7d). استخدم nodes remove --node <id|name|ip> لحذف سجل اقتران عقدة قديم مملوك لـ Gateway. ملاحظة الموافقة:
  • لا يحتاج 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.

ذات صلة