Exec-tool

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.

​

Parameters

• host is standaard auto: sandbox wanneer sandbox-runtime actief is voor de sessie, anders gateway.
• host accepteert alleen auto, sandbox, gateway of node. Het is geen hostnaamselector; waarden die op hostnamen lijken worden afgewezen voordat de opdracht wordt uitgevoerd.
• auto is de standaard routeringsstrategie, geen jokerteken. Per-aanroep host=node is toegestaan vanuit auto; per-aanroep host=gateway is alleen toegestaan wanneer er geen sandbox-runtime actief is.
• Zonder extra configuratie werkt host=auto nog steeds gewoon: geen sandbox betekent dat het wordt opgelost naar gateway; een live sandbox betekent dat het in de sandbox blijft.
• elevated ontsnapt uit de sandbox naar het geconfigureerde hostpad: standaard gateway, of node wanneer tools.exec.host=node (of de sessiestandaard host=node is). Het is alleen beschikbaar wanneer verhoogde toegang is ingeschakeld voor de huidige sessie/provider.
• Goedkeuringen voor gateway/node worden beheerd door ~/.openclaw/exec-approvals.json.
• node vereist een gekoppelde node (companion-app of headless node-host).
• Als er meerdere nodes beschikbaar zijn, stel dan exec.node of tools.exec.node in om er een te selecteren.
• exec host=node is het enige pad voor shelluitvoering voor nodes; de oude nodes.run-wrapper is verwijderd.
• timeout is van toepassing op uitvoering op de voorgrond, achtergrond, yieldMs, gateway, sandbox en node system.run. Als deze wordt weggelaten, gebruikt OpenClaw tools.exec.timeoutSec; expliciete timeout: 0 schakelt de exec-procestime-out voor die aanroep uit.
• Op niet-Windows-hosts gebruikt exec SHELL wanneer ingesteld; als SHELL fish is, geeft het de voorkeur aan bash (of sh) uit PATH om scripts te vermijden die niet compatibel zijn met fish, en valt daarna terug op SHELL als geen van beide bestaat.
• Op Windows-hosts geeft exec de voorkeur aan ontdekking van PowerShell 7 (pwsh) (Program Files, ProgramW6432, daarna PATH), en valt daarna terug op Windows PowerShell 5.1.
• Hostuitvoering (gateway/node) wijst env.PATH en loader-overschrijvingen (LD_*/DYLD_*) af om het kapen van binaries of geïnjecteerde code te voorkomen.
• OpenClaw stelt OPENCLAW_SHELL=exec in de opdrachtomgeving van de gestartte opdracht in (inclusief PTY- en sandboxuitvoering), zodat shell-/profielregels exec-toolcontext kunnen detecteren.
• openclaw channels login wordt geblokkeerd vanuit exec omdat het een interactieve channel-auth-flow is; voer het uit in een terminal op de gateway-host, of gebruik de channel-native login-tool vanuit chat wanneer die bestaat.
• Belangrijk: sandboxing staat standaard uit. Als sandboxing uitstaat, wordt impliciet host=auto opgelost naar gateway. Expliciet host=sandbox faalt nog steeds gesloten in plaats van stilzwijgend op de gateway-host uit te voeren. Schakel sandboxing in of gebruik host=gateway met goedkeuringen.
• Script-preflightcontroles (voor veelvoorkomende Python-/Node-shellsyntaxfouten) inspecteren alleen bestanden binnen de effectieve workdir-grens. Als een scriptpad buiten workdir wordt opgelost, wordt preflight voor dat bestand overgeslagen.
• Voor langlopende werkzaamheden die nu starten: start ze eenmaal en vertrouw op automatische voltooiingswake wanneer die is ingeschakeld en de opdracht uitvoer produceert of faalt. Gebruik process voor logs, status, invoer of interventie; emuleer geen planning met slaaplussen, time-outlussen of herhaalde polling.
• Voor werk dat later of volgens een schema moet plaatsvinden, gebruik cron in plaats van exec-slaap-/vertragingspatronen.

​

Configuratie

• tools.exec.notifyOnExit (standaard: true): wanneer true, plaatsen op de achtergrond gezette exec-sessies een systeemgebeurtenis in de wachtrij en vragen ze bij afsluiten een Heartbeat aan.
• tools.exec.approvalRunningNoticeMs (standaard: 10000): emit één “running”-melding wanneer een exec met verplichte goedkeuring langer draait dan dit (0 schakelt uit).
• tools.exec.timeoutSec (standaard: 1800): standaard exec-time-out per opdracht in seconden. Per-aanroep timeout overschrijft deze; per-aanroep timeout: 0 schakelt de exec-procestime-out uit.
• tools.exec.host (standaard: auto; wordt opgelost naar sandbox wanneer sandbox-runtime actief is, anders gateway)
• tools.exec.security (standaard: deny voor sandbox, full voor gateway + node wanneer niet ingesteld)
• tools.exec.ask (standaard: off)
• Host-exec zonder goedkeuring is standaard voor gateway + node. Als u goedkeurings-/toestemmingslijstgedrag wilt, verstrak dan zowel tools.exec.* als de host ~/.openclaw/exec-approvals.json; zie Exec-goedkeuringen.
• YOLO komt voort uit de standaardwaarden van het hostbeleid (security=full, ask=off), niet uit host=auto. Als u gateway- of node-routering wilt afdwingen, stel dan tools.exec.host in of gebruik /exec host=....
• In de modus security=full plus ask=off volgt host-exec direct het geconfigureerde beleid; er is geen extra heuristische prefilter voor opdrachtverduistering of script-preflightafwijzingslaag.
• tools.exec.node (standaard: niet ingesteld)
• tools.exec.strictInlineEval (standaard: false): wanneer true, vereisen inline interpreter-evalvormen zoals python -c, node -e, ruby -e, perl -e, php -r, lua -e en osascript -e altijd expliciete goedkeuring. allow-always kan nog steeds goedaardige interpreter-/scriptaanroepen blijven toestaan, maar inline-evalvormen vragen nog steeds elke keer om bevestiging.
• tools.exec.pathPrepend: lijst met mappen die vóór PATH moeten worden geplaatst voor exec-runs (alleen gateway + sandbox).
• tools.exec.safeBins: veilige binaries met alleen stdin die zonder expliciete toestemmingslijstvermeldingen kunnen worden uitgevoerd. Zie Veilige bins voor gedragsdetails.
• tools.exec.safeBinTrustedDirs: aanvullende expliciete mappen die worden vertrouwd voor safeBins-padcontroles. PATH-items worden nooit automatisch vertrouwd. Ingebouwde standaardwaarden zijn /bin en /usr/bin.
• tools.exec.safeBinProfiles: optioneel aangepast argv-beleid per veilige bin (minPositional, maxPositional, allowedValueFlags, deniedFlags).

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

​

PATH-afhandeling

• host=gateway: voegt uw login-shell-PATH samen in de exec-omgeving. env.PATH-overschrijvingen worden afgewezen voor hostuitvoering. De daemon zelf draait nog steeds met een minimale PATH:
  • macOS: /opt/homebrew/bin, /usr/local/bin, /usr/bin, /bin
  • Linux: /usr/local/bin, /usr/bin, /bin
• host=sandbox: voert sh -lc (login-shell) uit binnen de container, dus /etc/profile kan PATH resetten. OpenClaw plaatst env.PATH vóór na het sourcen van het profiel via een interne env-var (geen shellinterpolatie); tools.exec.pathPrepend is hier ook van toepassing.
• host=node: alleen niet-geblokkeerde env-overschrijvingen die u doorgeeft, worden naar de node verzonden. env.PATH-overschrijvingen worden afgewezen voor hostuitvoering en genegeerd door node-hosts. Als u extra PATH-items op een node nodig hebt, configureer dan de serviceomgeving van de node-host (systemd/launchd) of installeer tools op standaardlocaties.

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

​

Sessieoverschrijvingen (/exec)

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

​

Autorisatiemodel

​

Exec-goedkeuringen (companion-app / node-host)

​

Toestemmingslijst + veilige bins

• tools.exec.safeBins: kleine, alleen-stdin streamfilters.
• tools.exec.safeBinTrustedDirs: expliciete extra vertrouwde mappen voor uitvoerbare paden van veilige bins.
• tools.exec.safeBinProfiles: expliciet argv-beleid voor aangepaste veilige bins.
• toestemmingslijst: expliciet vertrouwen voor uitvoerbare paden.

​

Voorbeelden

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

• Alleen beschikbaar voor OpenAI-/OpenAI Codex-modellen.
• Toolbeleid blijft van toepassing; allow: ["write"] staat impliciet apply_patch toe.
• Configuratie bevindt zich onder tools.exec.applyPatch.
• tools.exec.applyPatch.enabled is standaard true; stel dit in op false om de tool voor OpenAI-modellen uit te schakelen.
• tools.exec.applyPatch.workspaceOnly is standaard true (binnen de workspace). Stel dit alleen in op false als je bewust wilt dat apply_patch buiten de workspace-directory schrijft/verwijdert.

​

Gerelateerd

• Exec-goedkeuringen — goedkeuringspoorten voor shellopdrachten
• Sandboxing — opdrachten uitvoeren in sandboxomgevingen
• Achtergrondproces — langlopende exec- en process-tool
• Beveiliging — toolbeleid en verhoogde toegang