أوامر CLI

node

شغّل مضيف عقدة بدون واجهة رسومية يتصل ببوابة WebSocket ويعرض system.run / system.which على هذه الآلة.

لماذا تستخدم مضيف عقدة؟

استخدم مضيف عقدة عندما تريد أن تقوم الوكلاء بتشغيل أوامر على آلات أخرى في شبكتك دون تثبيت تطبيق macOS المصاحب الكامل هناك. حالات الاستخدام الشائعة:

  • تشغيل أوامر على أجهزة Linux/Windows البعيدة (خوادم البناء، آلات المختبر، NAS).
  • الحفاظ على التنفيذ معزولاً على البوابة، ولكن تفويض عمليات التشغيل المعتمدة إلى مضيفين آخرين.
  • توفير هدف تنفيذ خفيف الوزن وبدون واجهة للأتمتة أو عقد CI.

لا يزال التنفيذ محمياً بواسطة موافقات التنفيذ وقوائم السمح لكل وكيل على مضيف العقدة، بحيث يمكنك الحفاظ على نطاق وصول الأوامر وصريحاً.

وكيل المتصفح (تكوين صفري)

تقوم مضيفات العقدة تلقائياً بالإعلان عن وكيل متصفح إذا لم يتم تعطيل browser.enabled على العقدة. هذا يسمح للوكيل باستخدام أتمتة المتصفح على تلك العقدة دون تكوين إضافي. قم بتعطيله على العقدة إذا لزم الأمر:

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

تشغيل (في المقدمة)

openclaw node run --host <gateway-host> --port 18789

الخيارات:

  • --host <host>: مضيف بوابة WebSocket (الافتراضي: 127.0.0.1)
  • --port <port>: منفذ بوابة WebSocket (الافتراضي: 18789)
  • --tls: استخدام TLS لاتصال البوابة
  • --tls-fingerprint <sha256>: بصمة شهادة TLS المتوقعة (sha256)
  • --node-id <id>: تجاوز معرف العقدة (يمسح رمز الاقتران)
  • --display-name <name>: تجاوز اسم العرض للعقدة

الخدمة (في الخلفية)

قم بتثبيت مضيف عقدة بدون واجهة كخدمة مستخدم.

openclaw node install --host <gateway-host> --port 18789

الخيارات:

  • --host <host>: مضيف بوابة WebSocket (الافتراضي: 127.0.0.1)
  • --port <port>: منفذ بوابة WebSocket (الافتراضي: 18789)
  • --tls: استخدام TLS لاتصال البوابة
  • --tls-fingerprint <sha256>: بصمة شهادة TLS المتوقعة (sha256)
  • --node-id <id>: تجاوز معرف العقدة (يمسح رمز الاقتران)
  • --display-name <name>: تجاوز اسم العرض للعقدة
  • --runtime <runtime>: وقت تشغيل الخدمة (node أو bun)
  • --force: إعادة التثبيت/الكتابة فوق إذا كانت مثبتة بالفعل

إدارة الخدمة:

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

استخدم openclaw node run لمضيف عقدة في المقدمة (بدون خدمة). تقبل أوامر الخدمة --json للإخراج القابل للقراءة آلياً.

الاقتران

ينشئ الاتصال الأول طلب اقتران جهاز معلق (role: node) على البوابة. قم بالموافقة عليه عبر:

openclaw devices list
openclaw devices approve <requestId>

يقوم مضيف العقدة بتخزين معرف العقدة، الرمز المميز، اسم العرض، ومعلومات اتصال البوابة في ~/.openclaw/node.json.

موافقات التنفيذ

يتم التحكم في system.run بواسطة موافقات التنفيذ المحلية:

modelsnodes