أداة التنفيذ

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.

​

المعلمات

• القيمة الافتراضية لـ host هي auto: sandbox عندما يكون وقت تشغيل sandbox نشطًا للجلسة، وإلا Gateway.
• لا يقبل host إلا auto أو sandbox أو gateway أو node. ليس محدد اسم مضيف؛ تُرفض القيم الشبيهة بأسماء المضيفين قبل تشغيل الأمر.
• auto هي استراتيجية التوجيه الافتراضية، وليست حرف بدل. يُسمح بـ host=node لكل استدعاء من auto؛ ولا يُسمح بـ host=gateway لكل استدعاء إلا عندما لا يكون وقت تشغيل sandbox نشطًا.
• من دون أي تكوين إضافي، يظل host=auto “يعمل مباشرة”: عدم وجود sandbox يعني أنه يتحول إلى gateway؛ ووجود sandbox نشط يعني أنه يبقى داخل sandbox.
• يخرج elevated من sandbox إلى مسار المضيف المكوّن: gateway افتراضيًا، أو node عندما يكون tools.exec.host=node (أو عندما تكون القيمة الافتراضية للجلسة هي host=node). لا يتوفر إلا عند تمكين الوصول المرتفع للجلسة/المزوّد الحالي.
• تتحكم ~/.openclaw/exec-approvals.json في موافقات gateway/node.
• يتطلب node عقدة مقترنة (تطبيقًا مرافقًا أو مضيف عقدة بلا واجهة).
• إذا كانت عدة عُقد متاحة، فاضبط exec.node أو tools.exec.node لاختيار واحدة.
• exec host=node هو مسار تنفيذ shell الوحيد للعُقد؛ وقد أُزيل الغلاف القديم nodes.run.
• تنطبق timeout على تنفيذ المقدمة، والخلفية، وyieldMs، وGateway، وsandbox، وsystem.run في node. إذا حُذفت، يستخدم OpenClaw tools.exec.timeoutSec؛ وتؤدي timeout: 0 الصريحة إلى تعطيل مهلة عملية exec لذلك الاستدعاء.
• على مضيفي غير Windows، يستخدم exec المتغير SHELL عندما يكون مضبوطًا؛ وإذا كان SHELL هو fish، فإنه يفضّل bash (أو sh) من PATH لتجنب السكربتات غير المتوافقة مع fish، ثم يعود إلى SHELL إذا لم يوجد أي منهما.
• على مضيفي Windows، يفضّل exec اكتشاف PowerShell 7 (pwsh) (Program Files، ثم ProgramW6432، ثم PATH)، ثم يعود إلى Windows PowerShell 5.1.
• يرفض تنفيذ المضيف (gateway/node) تجاوزات env.PATH وتجاوزات المحمّل (LD_*/DYLD_*) من أجل منع اختطاف الثنائيات أو حقن الشيفرة.
• يضبط OpenClaw المتغير OPENCLAW_SHELL=exec في بيئة الأمر المُنشأة (بما في ذلك تنفيذ PTY وsandbox) حتى تتمكن قواعد shell/profile من اكتشاف سياق أداة exec.
• يُحظر openclaw channels login من exec لأنه تدفق مصادقة قناة تفاعلي؛ شغّله في طرفية على مضيف Gateway، أو استخدم أداة تسجيل الدخول الأصلية للقناة من الدردشة عندما تكون موجودة.
• مهم: يكون sandboxing معطّلًا افتراضيًا. إذا كان sandboxing معطّلًا، فإن host=auto الضمني يتحول إلى gateway. يظل host=sandbox الصريح يفشل بشكل مغلق بدلًا من التشغيل الصامت على مضيف Gateway. فعّل sandboxing أو استخدم host=gateway مع الموافقات.
• لا تفحص اختبارات التمهيد المسبق للسكربتات (لأخطاء صياغة shell الشائعة في Python/Node) إلا الملفات داخل حد workdir الفعّال. إذا تحول مسار سكربت إلى خارج workdir، فيُتخطى التمهيد المسبق لذلك الملف.
• بالنسبة للعمل طويل التشغيل الذي يبدأ الآن، ابدأه مرة واحدة واعتمد على تنبيه الاكتمال التلقائي عندما يكون مفعّلًا ويصدر الأمر مخرجات أو يفشل. استخدم process للسجلات، أو الحالة، أو الإدخال، أو التدخل؛ ولا تحاكِ الجدولة بحلقات sleep، أو حلقات timeout، أو الاستطلاع المتكرر.
• بالنسبة للعمل الذي يجب أن يحدث لاحقًا أو وفق جدول، استخدم Cron بدلًا من أنماط sleep/delay في exec.

​

التكوين

• tools.exec.notifyOnExit (الافتراضي: true): عندما تكون true، تضع جلسات exec التي أُرسلت إلى الخلفية حدث نظام في قائمة الانتظار وتطلب Heartbeat عند الخروج.
• tools.exec.approvalRunningNoticeMs (الافتراضي: 10000): إصدار إشعار “قيد التشغيل” واحد عندما يعمل exec الخاضع للموافقة لمدة أطول من ذلك (0 يعطّل).
• tools.exec.timeoutSec (الافتراضي: 1800): مهلة exec الافتراضية لكل أمر بالثواني. تتجاوزها timeout لكل استدعاء؛ وتؤدي timeout: 0 لكل استدعاء إلى تعطيل مهلة عملية exec.
• tools.exec.host (الافتراضي: auto؛ يتحول إلى sandbox عندما يكون وقت تشغيل sandbox نشطًا، وإلى gateway بخلاف ذلك)
• tools.exec.security (الافتراضي: deny لـ sandbox، وfull لـ Gateway + node عند عدم الضبط)
• tools.exec.ask (الافتراضي: off)
• تنفيذ exec على المضيف من دون موافقة هو الافتراضي لـ Gateway + node. إذا أردت سلوك الموافقات/قائمة السماح، فشدّد كلًا من tools.exec.* وملف المضيف ~/.openclaw/exec-approvals.json؛ راجع موافقات Exec.
• تأتي YOLO من افتراضات سياسة المضيف (security=full، ask=off)، وليس من host=auto. إذا أردت فرض توجيه Gateway أو node، فاضبط tools.exec.host أو استخدم /exec host=....
• في وضع security=full مع ask=off، يتبع exec على المضيف السياسة المكوّنة مباشرةً؛ لا توجد طبقة إضافية لمرشح تمهيدي لاكتشاف تعمية الأوامر أو رفض التمهيد المسبق للسكربتات.
• tools.exec.node (الافتراضي: غير مضبوط)
• tools.exec.strictInlineEval (الافتراضي: false): عندما تكون true، تتطلب صيغ تقييم المفسّر المضمنة مثل python -c وnode -e وruby -e وperl -e وphp -r وlua -e وosascript -e موافقة صريحة دائمًا. لا يزال بإمكان allow-always حفظ استدعاءات المفسّر/السكربت الحميدة، لكن صيغ inline-eval تظل تطلب الموافقة في كل مرة.
• tools.exec.commandHighlighting (الافتراضي: false): عندما تكون true، يمكن لمطالبات الموافقة تمييز مقاطع الأوامر المستخرجة من المحلل في نص الأمر. اضبطها على true عالميًا أو لكل وكيل لتمكين تمييز نص الأمر من دون تغيير سياسة موافقة exec.
• tools.exec.pathPrepend: قائمة أدلة تُضاف في بداية PATH لتشغيلات exec (Gateway + sandbox فقط).
• tools.exec.safeBins: ثنائيات آمنة مخصصة لـ stdin فقط ويمكن تشغيلها من دون إدخالات قائمة سماح صريحة. لتفاصيل السلوك، راجع الثنائيات الآمنة.
• tools.exec.safeBinTrustedDirs: أدلة صريحة إضافية موثوقة لفحوصات مسار safeBins. لا تُوثق إدخالات PATH تلقائيًا أبدًا. الافتراضات المدمجة هي /bin و/usr/bin.
• tools.exec.safeBinProfiles: سياسة argv مخصصة اختيارية لكل ثنائي آمن (minPositional، maxPositional، allowedValueFlags، deniedFlags).

{
  tools: {
    exec: {
      pathPrepend: ["~/bin", "/opt/oss/bin"],
    },
  },
}

​

معالجة PATH

• host=gateway: يدمج PATH الخاص بـ login-shell لديك في بيئة exec. تُرفض تجاوزات env.PATH لتنفيذ المضيف. يظل daemon نفسه يعمل مع PATH أدنى:
  • macOS: /opt/homebrew/bin, /usr/local/bin, /usr/bin, /bin
  • Linux: /usr/local/bin, /usr/bin, /bin
• host=sandbox: يشغّل sh -lc (login shell) داخل الحاوية، لذلك قد يعيد /etc/profile ضبط PATH. يضيف OpenClaw env.PATH في البداية بعد تحميل profile عبر متغير بيئة داخلي (من دون استيفاء shell)؛ وينطبق tools.exec.pathPrepend هنا أيضًا.
• host=node: لا تُرسل إلى node إلا تجاوزات البيئة غير المحظورة التي تمررها. تُرفض تجاوزات env.PATH لتنفيذ المضيف وتتجاهلها مضيفات node. إذا احتجت إلى إدخالات PATH إضافية على node، فكوّن بيئة خدمة مضيف node (systemd/launchd) أو ثبّت الأدوات في المواقع القياسية.

openclaw config get agents.list
openclaw config set agents.list[0].tools.exec.node "node-id-or-name"

​

تجاوزات الجلسة (/exec)

/exec host=auto security=allowlist ask=on-miss node=mac-1

​

نموذج التخويل

​

موافقات Exec (التطبيق المرافق / مضيف node)

​

قائمة السماح + الثنائيات الآمنة

• tools.exec.safeBins: مرشحات تدفق صغيرة تعمل عبر stdin فقط.
• tools.exec.safeBinTrustedDirs: أدلة موثوقة إضافية وصريحة لمسارات الملفات التنفيذية لـ safe-bin.
• tools.exec.safeBinProfiles: سياسة argv صريحة لـ safe bins مخصصة.
• قائمة السماح: ثقة صريحة لمسارات الملفات التنفيذية.

​

أمثلة

{ "tool": "exec", "command": "ls -la" }

{"tool":"exec","command":"npm run build","yieldMs":1000}
{"tool":"process","action":"poll","sessionId":"<id>"}

{"tool":"process","action":"send-keys","sessionId":"<id>","keys":["Enter"]}
{"tool":"process","action":"send-keys","sessionId":"<id>","keys":["C-c"]}
{"tool":"process","action":"send-keys","sessionId":"<id>","keys":["Up","Up","Enter"]}

{ "tool": "process", "action": "submit", "sessionId": "<id>" }

{ "tool": "process", "action": "paste", "sessionId": "<id>", "text": "line1\nline2\n" }

​

apply_patch

{
  tools: {
    exec: {
      applyPatch: { workspaceOnly: true, allowModels: ["gpt-5.5"] },
    },
  },
}

• متاحة فقط لنماذج OpenAI/OpenAI Codex.
• تظل سياسة الأدوات مطبقة؛ يسمح allow: ["write"] ضمنيا بـ apply_patch.
• لا يرفض deny: ["write"] استخدام apply_patch؛ ارفض apply_patch صراحة أو استخدم deny: ["group:fs"] عندما يجب أيضا حظر عمليات الكتابة عبر التصحيح.
• توجد الإعدادات ضمن tools.exec.applyPatch.
• القيمة الافتراضية لـ tools.exec.applyPatch.enabled هي true؛ اضبطها على false لتعطيل الأداة لنماذج OpenAI.
• القيمة الافتراضية لـ tools.exec.applyPatch.workspaceOnly هي true (محصورة ضمن مساحة العمل). اضبطها على false فقط إذا كنت تريد عمدا أن يكتب apply_patch أو يحذف خارج دليل مساحة العمل.

​

ذو صلة

• موافقات exec — بوابات الموافقة لأوامر shell
• العزل — تشغيل الأوامر في بيئات معزولة
• عملية خلفية — أداة exec وprocess طويلة التشغيل
• الأمان — سياسة الأدوات والوصول المرتفع