​

openclaw nodes

​

الحالة

openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
openclaw nodes list
openclaw nodes describe --node <idOrNameOrIp>

​

الاقتران

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>

• يلغي remove إدخال الدور المقترن للعقدة. بالنسبة إلى عقدة مدعومة بجهاز، يُلغي هذا الدور node في مخزن اقتران الأجهزة ويفصل جلسات دور العقدة الخاصة بها: يحتفظ الجهاز متعدد الأدوار بصفه ولا يفقد سوى الدور node، بينما يُحذف صف الجهاز ذي دور العقدة فقط. ويزيل أيضًا أي سجل مطابق قديم لاقتران العُقد مملوك لـ Gateway.
• لا يحتاج pending إلا إلى النطاق operator.pairing.
• يمكن لـ gateway.nodes.pairing.autoApproveCidrs تخطي خطوة التعليق عند اقتران جهاز role: node موثوق به صراحةً للمرة الأولى. يكون معطّلًا افتراضيًا، ولا يوافق على ترقيات الأدوار.
• يوافق gateway.nodes.pairing.sshVerify (مفعّل افتراضيًا) تلقائيًا على اقتران جهاز role: node للمرة الأولى عندما يستطيع Gateway التحقق من مفتاح الجهاز عبر SSH إلى مضيف العقدة؛ وتتم الموافقة على سطح الإمكانات الأول في الخطوة نفسها. راجع اقتران العُقد.
• تتبع متطلبات نطاق approve الأوامر المعلنة في الطلب المعلّق:
  • طلب بلا أوامر: operator.pairing
  • أوامر العُقد العادية: operator.pairing + operator.write
  • الأوامر الحساسة إداريًا (system.run، وsystem.run.prepare، وsystem.which، وbrowser.proxy، وfs.listDir، وsystem.execApprovals.get/set): operator.pairing + operator.admin
• نطاق remove: يستطيع operator.pairing إزالة صفوف العُقد غير التابعة للمشغّل؛ ويحتاج المستدعي الذي يستخدم رمز جهاز ويلغي دور عقدته على جهاز متعدد الأدوار أيضًا إلى operator.admin.

​

الاستدعاء

openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

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

​

الإشعارات والدفع والموقع والشاشة

openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitive
openclaw nodes push --node <id> --title "OpenClaw" --environment sandbox
openclaw nodes location get --node <id> --accuracy precise
openclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4

• يرسل notify إشعارًا محليًا على عقدة تعلن system.notify، بما في ذلك عُقد macOS وiOS وAndroid وعُقد watchOS المباشرة. يتطلب التسليم المباشر إلى watchOS أن يكون OpenClaw نشطًا. يتطلب --title أو --body. الخيارات: --sound <name>، و--priority <passive|active|timeSensitive>، و--delivery <system|overlay|auto> (القيمة الافتراضية system)، و--invoke-timeout <ms> (القيمة الافتراضية 15000).
• يرسل push دفعة اختبار APNs إلى عقدة iOS. الخيارات: --title <text> (القيمة الافتراضية OpenClaw)، و--body <text>، و--environment <sandbox|production> لتجاوز بيئة APNs المكتشفة.
• يجلب location get الموقع الحالي للعقدة. الخيارات: --max-age <ms> (إعادة استخدام تحديد موقع مخزّن مؤقتًا)، و--accuracy <coarse|balanced|precise>، و--location-timeout <ms> (القيمة الافتراضية 10000)، و--invoke-timeout <ms> (القيمة الافتراضية 20000).
• يلتقط screen record مقطعًا قصيرًا ويطبع المسار المحفوظ (أو يكتب JSON باستخدام --json). الخيارات: --screen <index> (القيمة الافتراضية 0)، و--duration <ms|10s> (القيمة الافتراضية 10000)، و--fps <fps> (القيمة الافتراضية 10)، و--no-audio، و--out <path>، و--invoke-timeout <ms> (القيمة الافتراضية 120000).

​

ذات صلة

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