myskill
myskill executes commands with configurable environment, working directory, timeout, terminal mode, host targeting, and security enforcement options.
command(required)workdir(defaults to cwd)env(key/value overrides)yieldMs(default 10000): auto-background after delaybackground(bool): background immediatelytimeout(seconds, default 1800): kill on expirypty(bool): run in a pseudo-terminal when available (TTY-only CLIs, coding agents, terminal UIs)host(sandbox | gateway | node): where to executesecurity(deny | allowlist | full): enforcement mode forgateway/nodeask(off | on-miss | always): approval prompts forgateway/nodenode(string): node id/name forhost=nodeelevated(bool): request elevated mode (gateway host);security=fullis only forced when elevated resolves tofull
Notes:
hostdefaults tosandbox.elevatedis ignored when sandboxing is off (exec already runs on the host).gateway/nodeapprovals are controlled by~/.openclaw/exec-approvals.json.noderequires a paired node (companion app or headless node host).- If multiple nodes are available, set
exec.nodeortools.exec.nodeto select one. - On non-Windows hosts, exec uses
SHELLwhen set; ifSHELLisfish, it prefersbash(orsh) fromPATHto avoid fish-incompatible scripts, then falls back toSHELLif neither exists. - On Windows hosts, exec prefers PowerShell 7 (
pwsh) discovery (Program Files, ProgramW6432, then PATH), then falls back to Windows PowerShell 5.1. - Host execution (
gateway/node) rejectsenv.PATHand loader overrides (LD_*/DYLD_*) to prevent binary hijacking or injected code. - Important: sandboxing is off by default. If sandboxing is off and
host=sandboxis explicitly configured/requested, exec now fails closed instead of silently running on the gateway host. Enable sandboxing or usehost=gatewaywith approvals. - Script preflight checks (for common Python/Node shell-syntax mistakes) only inspect files inside the effective
workdirboundary. If a script path resolves outsideworkdir, preflight is skipped for that file.
Config
tools.exec.notifyOnExit(default: true): when true, backgrounded exec sessions enqueue a system event and request a heartbeat on exit.tools.exec.approvalRunningNoticeMs(default: 10000): emit a single “running” notice when an approval-gated exec runs longer than this (0 disables).tools.exec.host(default:sandbox)tools.exec.security(default:denyfor sandbox,allowlistfor gateway + node when unset)tools.exec.ask(default:on-miss)tools.exec.node(default: unset)tools.exec.pathPrepend: list of directories to prepend toPATHfor exec runs (gateway + sandbox only).tools.exec.safeBins: stdin-only safe binaries that can run without explicit allowlist entries. For behavior details, see Safe bins.tools.exec.safeBinTrustedDirs: additional explicit directories trusted forsafeBinspath checks.PATHentries are never auto-trusted. Built-in defaults are/binand/usr/bin.tools.exec.safeBinProfiles: optional custom argv policy per safe bin (minPositional,maxPositional,allowedValueFlags,deniedFlags).
Related skills
- Downloads
- 693All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.1
- License
- MIT-0
