> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# الموافقات

# `openclaw approvals`

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

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

ذات صلة:

* موافقات التنفيذ: [موافقات التنفيذ](/ar/tools/exec-approvals)
* Nodes: [Nodes](/ar/nodes)

## `openclaw exec-policy`

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

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

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

أمثلة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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>`.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 ويشير إلى تعذّر حساب سياسة وقت التشغيل النهائية

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw approvals set --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF
```

صيغة Node:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw approvals set --node <id|name|ip> --stdin <<'EOF'
{
  version: 1,
  defaults: {
    security: "full",
    ask: "off",
    askFallback: "full"
  }
}
EOF
```

يغيّر هذا **ملف موافقات المضيف** فقط. لإبقاء سياسة OpenClaw المطلوبة متطابقة، عيّن أيضًا:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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"`
صراحةً عند ترقية مضيف بلا واجهة مستخدم يجب أن يحافظ على سلوك عدم المطالبة مطلقًا.

اختصار محلي:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw exec-policy preset yolo
```

يحدّث ذلك الاختصار المحلي كلًا من إعدادات `tools.exec.*` المحلية المطلوبة
وافتراضيات الموافقات المحلية معًا. وهو مكافئ من حيث المقصود للإعداد اليدوي ذي الخطوتين
أعلاه، لكن للجهاز المحلي فقط.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/ar/cli)
* [موافقات التنفيذ](/ar/tools/exec-approvals)