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 node

​

لماذا تستخدم مضيف Node؟

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

​

وكيل المتصفح (بلا إعداد)

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

​

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

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

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

​

مصادقة Gateway لمضيف Node

• يتم فحص OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD أولًا.
• ثم الرجوع إلى الإعداد المحلي: gateway.auth.token / gateway.auth.password.
• في الوضع المحلي، لا يرث مضيف Node عمدًا gateway.remote.token / gateway.remote.password.
• إذا تم تكوين gateway.auth.token / gateway.auth.password صراحةً عبر SecretRef ولم يُحل، يفشل حل مصادقة Node بشكل مغلق (من دون رجوع بعيد يخفي ذلك).
• في gateway.mode=remote، تصبح حقول العميل البعيد (gateway.remote.token / gateway.remote.password) مؤهلة أيضًا وفق قواعد أولوية البعيد.
• لا يراعي حل مصادقة مضيف Node إلا متغيرات البيئة OPENCLAW_GATEWAY_*.

​

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

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

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

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

​

الاقتران

openclaw devices list
openclaw devices approve <requestId>

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

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

• ~/.openclaw/exec-approvals.json
• موافقات التنفيذ
• openclaw approvals --node <id|name|ip> (تحرير من Gateway)

​

ذو صلة

• مرجع CLI
• Nodes