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

​
openclaw approvals

إدارة موافقات التنفيذ للمضيف المحلي، أو مضيف Gateway، أو مضيف Node. افتراضيًا، تستهدف الأوامر ملف الموافقات المحلي على القرص. استخدم --gateway لاستهداف Gateway، أو --node لاستهداف Node محدد. الاسم المستعار: openclaw exec-approvals ذات صلة:

​
openclaw exec-policy

openclaw exec-policy هو أمر الملاءمة المحلي لإبقاء إعدادات tools.exec.* المطلوبة وملف موافقات المضيف المحلي متطابقين في خطوة واحدة. استخدمه عندما تريد:
  • فحص السياسة المحلية المطلوبة، وملف موافقات المضيف، والدمج الفعلي
  • تطبيق إعداد محلي مسبق مثل YOLO أو رفض الكل
  • مزامنة tools.exec.* المحلي وملف موافقات المضيف المحلي
أمثلة: 
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 في هذا الأمر لأن موافقات التنفيذ على Node تُجلب من Node في وقت التشغيل ويجب إدارتها عبر أوامر الموافقات الموجهة إلى Node بدلًا من ذلك
  • يضع openclaw exec-policy show علامة على نطاقات host=node بأنها مُدارة بواسطة Node في وقت التشغيل بدلًا من اشتقاق سياسة فعالة من ملف الموافقات المحلي
إذا كنت بحاجة إلى تحرير موافقات المضيف البعيد مباشرةً، فاستمر في استخدام openclaw approvals set --gateway أو openclaw approvals set --node <id|name|ip>.

​
الأوامر الشائعة

openclaw approvals get
openclaw approvals get --node <id|name|ip>
openclaw approvals get --gateway
يعرض openclaw approvals get الآن سياسة التنفيذ الفعلية للأهداف المحلية، وGateway، وNode:
  • سياسة 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", askFallback: "full" } }
EOF
openclaw approvals set --node <id|name|ip> --file ./exec-approvals.json
openclaw approvals set --gateway --file ./exec-approvals.json
يقبل set صيغة JSON5، وليس JSON الصارم فقط. استخدم إما --file أو --stdin، وليس كليهما.

​
مثال “عدم المطالبة مطلقًا” / YOLO

بالنسبة إلى مضيف لا ينبغي أن يتوقف أبدًا عند موافقات التنفيذ، عيّن افتراضيات موافقات المضيف إلى full + off: 
openclaw approvals set --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF
صيغة Node: 
openclaw approvals set --node <id|name|ip> --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF
يغيّر هذا ملف موافقات المضيف فقط. لإبقاء سياسة OpenClaw المطلوبة متطابقة، عيّن أيضًا: 
openclaw config set tools.exec.host gateway
openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off
لماذا tools.exec.host=gateway في هذا المثال:
  • لا يزال host=auto يعني “استخدام sandbox عند توفره، وإلا Gateway”.
  • YOLO يتعلق بالموافقات، وليس بالتوجيه.
  • إذا كنت تريد تنفيذ المضيف حتى عند إعداد sandbox، فاجعل اختيار المضيف صريحًا باستخدام gateway أو /exec host=gateway.
القيمة الافتراضية لـ askFallback عند حذفها هي deny. عيّن askFallback: "full" صراحةً عند ترقية مضيف بلا واجهة مستخدم يجب أن يحافظ على سلوك عدم المطالبة مطلقًا. اختصار محلي: 
openclaw exec-policy preset yolo
يحدّث ذلك الاختصار المحلي كلًا من إعدادات tools.exec.* المحلية المطلوبة وافتراضيات الموافقات المحلية معًا. وهو مكافئ من حيث المقصود للإعداد اليدوي ذي الخطوتين أعلاه، لكن للجهاز المحلي فقط.

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

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"

​
الخيارات الشائعة

يدعم كل من get، وset، وallowlist add|remove ما يلي:
  • --node <id|name|ip>
  • --gateway
  • خيارات RPC المشتركة لـ Node: --url، --token، --timeout، --json
ملاحظات الاستهداف:
  • عدم وجود أعلام هدف يعني ملف الموافقات المحلي على القرص
  • يستهدف --gateway ملف موافقات مضيف Gateway
  • يستهدف --node مضيف Node واحدًا بعد حل المعرّف، أو الاسم، أو عنوان IP، أو بادئة المعرّف
يدعم allowlist add|remove أيضًا:
  • --agent <id> (القيمة الافتراضية هي *)

​
ملاحظات

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

​
ذات صلة