openclaw approvals

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

الاسم المستعار: openclaw exec-approvals

ذات صلة:

• موافقات التنفيذ: موافقات التنفيذ
• Nodes: Nodes

openclaw exec-policy

openclaw exec-policy هو أمر الملاءمة المحلي لإبقاء إعدادات tools.exec.* المطلوبة وملف موافقات المضيف المحلي متطابقين في خطوة واحدة.

استخدمه عندما تريد:

• فحص السياسة المحلية المطلوبة، وملف موافقات المضيف، والدمج الفعلي
• تطبيق إعداد محلي مسبق مثل YOLO أو رفض الكل
• مزامنة tools.exec.* المحلي وملف موافقات المضيف المحلي

أمثلة:

openclaw exec-policy showopenclaw exec-policy show --json openclaw exec-policy preset yoloopenclaw 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 getopenclaw 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.jsonopenclaw approvals set --stdin <<'EOF'{ version: 1, defaults: { security: "full", ask: "off", askFallback: "full" } }EOFopenclaw approvals set --node <id|name|ip> --file ./exec-approvals.jsonopenclaw 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 gatewayopenclaw config set tools.exec.security fullopenclaw 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 عندما لا يكون المتغير مضبوطًا).

ذات صلة

• مرجع CLI
• موافقات التنفيذ