Exec टूल

​

पैरामीटर

• host केवल auto, sandbox, gateway, या node स्वीकार करता है। यह होस्टनाम चयनकर्ता नहीं है; होस्टनाम जैसे मान कमांड चलने से पहले अस्वीकार कर दिए जाते हैं।
• प्रति-कॉल host=node की अनुमति auto से है; प्रति-कॉल host=gateway की अनुमति केवल तभी है जब कोई सैंडबॉक्स रनटाइम सक्रिय न हो।
• बिना किसी अतिरिक्त कॉन्फ़िगरेशन के भी host=auto सामान्य रूप से काम करता है: सैंडबॉक्स न होने पर यह gateway में रिज़ॉल्व होता है; सक्रिय सैंडबॉक्स होने पर यह सैंडबॉक्स में ही रहता है।
• elevated सैंडबॉक्स से निकलकर कॉन्फ़िगर किए गए होस्ट पथ पर जाता है: डिफ़ॉल्ट रूप से gateway, या tools.exec.host=node (या सत्र डिफ़ॉल्ट host=node) होने पर node। यह केवल तभी उपलब्ध है जब वर्तमान सत्र/प्रदाता के लिए उन्नत पहुँच सक्षम हो।
• gateway/node अनुमोदन होस्ट अनुमोदन फ़ाइल द्वारा नियंत्रित होते हैं।
• node के लिए युग्मित Node (सहयोगी ऐप या हेडलेस Node होस्ट) आवश्यक है। यदि एक से अधिक Node उपलब्ध हों, तो किसी एक को चुनने के लिए exec.node या tools.exec.node सेट करें।
• exec host=node Node के लिए एकमात्र शेल-निष्पादन पथ है; पुराना nodes.run रैपर हटा दिया गया है।
• गैर-Windows होस्ट पर, सेट होने पर exec SHELL का उपयोग करता है; यदि SHELL, fish है, तो fish से असंगत bash संरचनाओं से बचने के लिए यह PATH से bash (या sh) को प्राथमिकता देता है, फिर दोनों में से कोई भी मौजूद न होने पर SHELL का उपयोग करता है।
• Windows होस्ट पर, exec PowerShell 7 (pwsh) खोज (Program Files, ProgramW6432, फिर PATH) को प्राथमिकता देता है, फिर Windows PowerShell 5.1 का उपयोग करता है।
• गैर-Windows gateway होस्ट पर, bash और zsh exec कमांड स्टार्टअप स्नैपशॉट का उपयोग करते हैं। OpenClaw शेल स्टार्टअप फ़ाइलों से सोर्स किए जा सकने वाले उपनाम/फ़ंक्शन और एक छोटा सुरक्षित परिवेश सेट लेकर $OPENCLAW_STATE_DIR/cache/shell-snapshots/ में संग्रहीत करता है, फिर प्रत्येक exec कमांड से पहले उस स्नैपशॉट को सोर्स करता है। सीक्रेट जैसे दिखने वाले वेरिएबल बाहर रखे जाते हैं; सैंडबॉक्स और Node exec इस स्नैपशॉट का उपयोग नहीं करते। इस स्नैपशॉट पथ को अक्षम करने के लिए Gateway प्रक्रिया परिवेश में OPENCLAW_EXEC_SHELL_SNAPSHOT=0 सेट करें।
• होस्ट निष्पादन (gateway/node) बाइनरी हाइजैकिंग या इंजेक्ट किए गए कोड को रोकने के लिए env.PATH और लोडर ओवरराइड (LD_*/DYLD_*) अस्वीकार करता है।
• OpenClaw आरंभ किए गए कमांड परिवेश (PTY और सैंडबॉक्स निष्पादन सहित) में OPENCLAW_SHELL=exec सेट करता है, ताकि शेल/प्रोफ़ाइल नियम exec-टूल संदर्भ पहचान सकें।
• चैनल से उत्पन्न रन के लिए, चैनल द्वारा वे आईडी प्रदान किए जाने पर OpenClaw OPENCLAW_CHANNEL_CONTEXT में सीमित प्रेषक/चैट पहचान JSON पेलोड भी उपलब्ध कराता है।
• exec, openclaw channels login या /approve शेल कमांड नहीं चला सकता: openclaw channels login एक इंटरैक्टिव चैनल-प्रमाणीकरण प्रवाह है और /approve को शेल के बजाय अनुमोदन कमांड हैंडलर से होकर जाना आवश्यक है। चैनल लॉगिन gateway होस्ट के टर्मिनल में चलाएँ, या उपलब्ध होने पर चैनल-विशिष्ट लॉगिन एजेंट टूल का उपयोग करें (उदाहरण के लिए whatsapp_login)।
• महत्वपूर्ण: सैंडबॉक्सिंग डिफ़ॉल्ट रूप से बंद है। यदि सैंडबॉक्सिंग बंद है, तो अंतर्निहित host=auto, gateway में रिज़ॉल्व होता है। स्पष्ट host=sandbox फिर भी gateway होस्ट पर चुपचाप चलने के बजाय सुरक्षित रूप से विफल होता है। सैंडबॉक्सिंग सक्षम करें या अनुमोदनों के साथ host=gateway का उपयोग करें।
• स्क्रिप्ट पूर्व-जाँच (सामान्य Python/Node शेल-सिंटैक्स त्रुटियों के लिए) केवल प्रभावी workdir सीमा के भीतर की फ़ाइलों की जाँच करती है। यदि कोई स्क्रिप्ट पथ workdir के बाहर रिज़ॉल्व होता है, तो उस फ़ाइल की पूर्व-जाँच छोड़ दी जाती है। host=gateway और प्रभावी नीति ask=off के साथ security=full होने पर पूर्व-जाँच पूरी तरह छोड़ दी जाती है।
• अभी शुरू होने वाले लंबे कार्य को एक बार शुरू करें और, सक्षम होने तथा कमांड द्वारा आउटपुट देने या विफल होने पर, स्वचालित पूर्णता वेक पर निर्भर रहें। लॉग, स्थिति, इनपुट या हस्तक्षेप के लिए process का उपयोग करें; sleep लूप, timeout लूप या बार-बार पोलिंग से शेड्यूलिंग का अनुकरण न करें।
• एजेंट द्वारा शुरू किए गए पृष्ठभूमि कमांड पूर्ण होने तक Web, iOS और Android के पृष्ठभूमि-कार्य दृश्यों में दिखाई देते हैं। पूर्णता Heartbeat द्वारा एजेंट को फिर जगाने से पहले कार्य लेजर को अंतिम रूप दिया जाता है।
• जो कार्य बाद में या किसी समय-सारणी के अनुसार होना चाहिए, उसके लिए exec sleep/delay पैटर्न के बजाय cron का उपयोग करें।

​

कॉन्फ़िगरेशन

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

​

मोड

​

इनलाइन eval (strictInlineEval)

​

PATH प्रबंधन

• host=gateway: आपके login-shell PATH को exec परिवेश में मिलाता है। Host निष्पादन के लिए env.PATH ओवरराइड अस्वीकृत किए जाते हैं। daemon स्वयं फिर भी न्यूनतम PATH के साथ चलता है:
  • macOS: /opt/homebrew/bin, /usr/local/bin, /usr/bin, /bin
  • Linux: /usr/local/bin, /usr/bin, /bin
  • स्टार्टअप के दौरान उपयोगकर्ता shell कॉन्फ़िगरेशन (जैसे ~/.zshenv या /etc/zshenv) को प्राथमिकता वाले पथों को ओवरराइड करने से रोकने के लिए, निष्पादन से ठीक पहले shell कमांड के भीतर अंतिम PATH में tools.exec.pathPrepend प्रविष्टियाँ सुरक्षित रूप से आगे जोड़ी जाती हैं।
• host=sandbox: कंटेनर के भीतर sh -lc (login shell) चलाता है, इसलिए /etc/profile, PATH को रीसेट कर सकता है। OpenClaw प्रोफ़ाइल स्रोत करने के बाद एक आंतरिक env var के माध्यम से env.PATH को आगे जोड़ता है (कोई shell interpolation नहीं); tools.exec.pathPrepend यहाँ भी लागू होता है।
• host=node: आपके द्वारा दिए गए केवल गैर-अवरुद्ध env ओवरराइड Node को भेजे जाते हैं। Host निष्पादन के लिए env.PATH ओवरराइड अस्वीकृत होते हैं और Node hosts द्वारा अनदेखे किए जाते हैं। यदि आपको किसी Node पर अतिरिक्त PATH प्रविष्टियों की आवश्यकता है, तो Node host सेवा परिवेश (systemd/launchd) कॉन्फ़िगर करें या टूल को मानक स्थानों पर इंस्टॉल करें।

openclaw config get agents.entries
openclaw config set 'agents.entries.main.tools.exec.node' "node-id-or-name"

​

सत्र ओवरराइड (/exec)

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

​

Exec अनुमोदन (सहयोगी ऐप / Node host)

​

अनुमत-सूची + सुरक्षित बिन

• tools.exec.safeBins: छोटे, केवल-stdin स्ट्रीम फ़िल्टर।
• tools.exec.safeBinTrustedDirs: सुरक्षित-बिन निष्पादन-योग्य पथों के लिए स्पष्ट अतिरिक्त विश्वसनीय निर्देशिकाएँ।
• tools.exec.safeBinProfiles: कस्टम सुरक्षित बिन के लिए स्पष्ट argv नीति।
• अनुमत-सूची: निष्पादन-योग्य पथों के लिए स्पष्ट विश्वास।

​

उदाहरण

{ "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.6-sol"] },
    },
  },
}

• टूल नीति फिर भी लागू होती है; allow: ["write"] अंतर्निहित रूप से apply_patch की अनुमति देता है।
• deny: ["write"], apply_patch को अस्वीकार नहीं करता; apply_patch को स्पष्ट रूप से अस्वीकार करें या जब पैच लेखन भी अवरुद्ध होना चाहिए, तब deny: ["group:fs"] का उपयोग करें।
• कॉन्फ़िगरेशन tools.exec.applyPatch के अंतर्गत रहता है।
• tools.exec.applyPatch.enabled का डिफ़ॉल्ट true है; टूल को अक्षम करने के लिए इसे false पर सेट करें।
• tools.exec.applyPatch.workspaceOnly का डिफ़ॉल्ट true (कार्यस्थान के भीतर सीमित) है। केवल तभी इसे false पर सेट करें, जब आप जानबूझकर चाहते हों कि apply_patch कार्यस्थान निर्देशिका के बाहर लिखे/हटाए।
• tools.exec.applyPatch.allowModels, मॉडल ID की वैकल्पिक अनुमत-सूची है (raw, जैसे gpt-5.4, या पूर्ण, जैसे openai/gpt-5.4)। सेट होने पर केवल मेल खाने वाले मॉडलों को टूल मिलता है; सेट न होने पर सभी मॉडलों को मिलता है।

​

संबंधित

• Exec अनुमोदन — shell कमांड के लिए अनुमोदन गेट
• Sandboxing — sandbox किए गए परिवेशों में कमांड चलाना
• पृष्ठभूमि प्रक्रिया — लंबे समय तक चलने वाला exec और process टूल
• सुरक्षा — टूल नीति और उन्नत पहुँच