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 approvals

• موافقات exec: موافقات exec
• Nodes: Nodes

​

openclaw exec-policy

• فحص السياسة المحلية المطلوبة، وملف موافقات المضيف، والدمج الفعّال
• تطبيق إعداد محلي مسبق مثل YOLO أو deny-all
• مزامنة tools.exec.* المحلي و~/.openclaw/exec-approvals.json المحلي

openclaw exec-policy show
openclaw exec-policy show --json

openclaw exec-policy preset yolo
openclaw exec-policy preset cautious --json

openclaw exec-policy set --host gateway --security full --ask off --ask-fallback full

• بدون --json: يطبع عرض الجدول المقروء للبشر
• مع --json: يطبع إخراجًا منظمًا قابلًا للقراءة الآلية

• exec-policy محلي فقط
• يحدّث ملف التهيئة المحلي وملف الموافقات المحلي معًا
• لا يدفع السياسة إلى مضيف Gateway أو مضيف Node
• يتم رفض --host node في هذا الأمر لأن موافقات exec الخاصة بـ Node تُجلَب من Node وقت التشغيل ويجب إدارتها عبر أوامر الموافقات الموجهة إلى Node بدلًا من ذلك
• يعلّم openclaw exec-policy show نطاقات host=node على أنها مُدارة من Node وقت التشغيل بدلًا من اشتقاق سياسة فعّالة من ملف الموافقات المحلي

​

أوامر شائعة

openclaw approvals get
openclaw approvals get --node <id|name|ip>
openclaw approvals get --gateway

• سياسة tools.exec المطلوبة
• سياسة ملف موافقات المضيف
• النتيجة الفعّالة بعد تطبيق قواعد الأسبقية

• ملف موافقات المضيف هو مصدر الحقيقة القابل للإنفاذ
• يمكن لسياسة tools.exec المطلوبة أن تضيق النية أو توسعها، لكن النتيجة الفعّالة تظل مشتقة من قواعد المضيف
• يجمع --node بين ملف موافقات مضيف Node وسياسة tools.exec الخاصة بـ Gateway، لأن كلاهما لا يزال يُطبَّق وقت التشغيل
• إذا لم تكن تهيئة Gateway متاحة، يعود CLI إلى لقطة موافقات Node ويشير إلى أنه لم يمكن حساب سياسة وقت التشغيل النهائية

​

استبدال الموافقات من ملف

openclaw approvals set --file ./exec-approvals.json
openclaw approvals set --stdin <<'EOF'
{ version: 1, defaults: { security: "full", ask: "off" } }
EOF
openclaw approvals set --node <id|name|ip> --file ./exec-approvals.json
openclaw approvals set --gateway --file ./exec-approvals.json

​

مثال “عدم السؤال مطلقًا” / YOLO

openclaw approvals set --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF

openclaw approvals set --node <id|name|ip> --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF

openclaw config set tools.exec.host gateway
openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off

• ما زال host=auto يعني “sandbox عند توفره، وإلا فـ Gateway”.
• يتعلق YOLO بالموافقات، وليس بالتوجيه.
• إذا كنت تريد exec على المضيف حتى عند تهيئة sandbox، فاجعل اختيار المضيف صريحًا باستخدام gateway أو /exec host=gateway.

openclaw exec-policy preset yolo

​

مساعدات قائمة السماح

openclaw approvals allowlist add "~/Projects/**/bin/rg"
openclaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
openclaw approvals allowlist add --agent "*" "/usr/bin/uname"

openclaw approvals allowlist remove "~/Projects/**/bin/rg"

​

خيارات شائعة

• --node <id|name|ip>
• --gateway
• خيارات RPC المشتركة الخاصة بـ Node: --url, --token, --timeout, --json

• عدم استخدام أي علامات استهداف يعني ملف الموافقات المحلي على القرص
• يستهدف --gateway ملف موافقات مضيف Gateway
• يستهدف --node مضيف Node واحدًا بعد resolve المعرّف أو الاسم أو IP أو بادئة المعرّف

• --agent <id> (الافتراضي *)

​

ملاحظات

• يستخدم --node نفس المحلِّل الذي يستخدمه openclaw nodes ‏(المعرّف أو الاسم أو ip أو بادئة المعرّف).
• القيمة الافتراضية لـ --agent هي "*", وهذا ينطبق على جميع الوكلاء.
• يجب أن يعلن مضيف Node عن system.execApprovals.get/set ‏(تطبيق macOS أو مضيف Node دون واجهة).
• تُخزَّن ملفات الموافقات لكل مضيف في ~/.openclaw/exec-approvals.json.

​

ذو صلة

• مرجع CLI
• موافقات exec