FC openclaw
OpenClaw development assistant, built by Michel Costa, co-founder of Brabaflow — AI-Native Agency (brabaflow.ai). Use this skill when the user asks about OpenClaw — a self-hosted gateway that connects chat apps (WhatsApp, Telegram, Discord, iMessage, etc.) to AI coding agents. Covers configuration, channels, providers, tools, plugins, deployment, CLI commands, and all aspects of OpenClaw development. 333 pages of verbatim official documentation from docs.openclaw.ai.
As a process C 51/100 · Has gaps — weak spots: result and completion, inputs and preconditions, consistency
What is at stake
The skill contains fragments that, in the wrong hands, cost money or data. Below: what the installer risks and what the author should do.
The skill contains commands that delete files, rewrite disks or execute code fetched from the network. The agent may run them without asking if it believes the instructions require it.
Replace destructive commands with safe equivalents that ask for confirmation, scope them to one folder, and stop piping curl into a shell: pin a version and a checksum.
The instructions or scripts send data out: environment variables, keys, file contents, chat history. You may never notice, because the agent performs the upload as "part of the task".
If the upload is not needed for the task, remove it: catalogs flag such skills and delist them. If it is needed, name the destination explicitly, say what leaves the machine, and give the user a switch.
The text contains phrases like "ignore previous instructions" or "you are now…". That is an attempt to hijack the agent: it may break your rules, the system limits or company policy.
An honest skill does not need them: state the role and the rules directly without overriding other instructions. Otherwise catalog scanners and corporate filters will block the listing.
Below is the worst case for this category. The finding here is medium: the guard saw a sign, not a proof.
The purpose itself is risky: wallets, browser password stores, offensive security. Even an honest implementation gives the agent access to things that cost money.
Explain in the description why the access is needed and how it is limited; add tests that show refusals on dangerous requests.
How to improve
- Address the high-severity findings: each costs 18 safety points. If one is a false positive, add the rule id to guard.allow in spec.yaml.
- Your own cases (evals/evals.json, 4–6 real requests with expected answers): the full check would then run those instead of a model-drafted suite.
- A spec.yaml with trigger phrases and assertions — a behaviour contract for CI; `skilltest init` writes a template.
Guard findings · 73
-
high Dangerous commands
cmd-persistencedocs/02-installation.md:1763Persistence mechanism (cron / launchd / scheduled task / autorun registry)rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
-
high Exfiltration
exfil-read-secret-filesdocs/03-gateway.md:7068Reads credential / secret filesssh-copy-id -i ~/.ssh/id_rsa <REMOTE_USER>@<REMOTE_IP>
-
high Dangerous commands
cmd-persistencedocs/03-gateway.md:7122Persistence mechanism (cron / launchd / scheduled task / autorun registry)launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist
-
high Dangerous commands
cmd-persistencedocs/04-channels.md:981Persistence mechanism (cron / launchd / scheduled task / autorun registry)launchctl unload ~/Library/LaunchAgents/com.user.poke-messages.plist 2>/dev/null || true
-
high Dangerous commands
cmd-persistencedocs/04-channels.md:982Persistence mechanism (cron / launchd / scheduled task / autorun registry)launchctl load ~/Library/LaunchAgents/com.user.poke-messages.plist
-
high Exfiltration
exfil-webhook-urldocs/04-channels.md:3064Webhook / callback URL commonly used for exfiltration (verify the destination)# Set messaging endpoint to: https://abc1….io/api/messages
-
high Dangerous commands
cmd-persistencedocs/05-providers.md:2470Persistence mechanism (cron / launchd / scheduled task / autorun registry)cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
-
high Dangerous commands
cmd-persistencedocs/05-providers.md:2495Persistence mechanism (cron / launchd / scheduled task / autorun registry)launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
-
high Instruction override
en-fake-system-promptdocs/06-tools.md:1658Fake system prompt injected into content* `systemPrompt`: full system prompt override.
-
high Dangerous commands
cmd-persistencedocs/12-platforms-desktop.md:128Persistence mechanism (cron / launchd / scheduled task / autorun registry)schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
-
high Dangerous commands
cmd-pipe-to-shelldocs/13-deploy.md:83Downloads and executes remote code from an unrecognised host (pipe to shell)curl -fsSL https://get.docker.com | sh
-
high Dangerous commands
cmd-pipe-to-shelldocs/13-deploy.md:473Downloads and executes remote code from an unrecognised host (pipe to shell)curl -fsSL https://get.docker.com | sudo sh
Medium and low: 61
-
medium Dangerous commands
cmd-pipe-to-shelldocs/02-installation.md:30Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/02-installation.md:34Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/02-installation.md:38Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/02-installation.md:42Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/02-installation.md:80Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/02-installation.md:405Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
-
medium Dangerous commands
cmd-shell-rcdocs/02-installation.md:741Writes to a shell startup fileecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc
-
medium Dangerous commands
cmd-privilegedocs/02-installation.md:885Privilege escalation / world-writable permissionssudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace
-
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/02-installation.md:898Pipe-to-shell installer from a well-known host (still executes remote code)RUN curl -fsSL https://bun.sh/install | bash
-
medium Exfiltration
exfil-read-secret-filesdocs/02-installation.md:906Reads credential / secret files (Dockerfile instruction (build context, not runtime exfiltration))COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
Dockerfile -
medium Dangerous commands
cmd-persistencedocs/03-gateway.md:7096Persistence mechanism (cron / launchd / scheduled task / autorun registry) (quoted — discussed, not commanded)Save this as `~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist`:
quoted -
medium Dangerous commands
cmd-persistencedocs/04-channels.md:942Persistence mechanism (cron / launchd / scheduled task / autorun registry) (quoted — discussed, not commanded)* `~/Library/LaunchAgents/com.user.poke-messages.plist`
quoted -
medium Exfiltration
exfil-webhook-urldocs/04-channels.md:3063Webhook / callback URL commonly used for exfiltration (verify the destination) (security demo / example)# Copy the https URL, e.g., https://abc1….io
demo -
medium Exfiltration
net-credential-usedocs/04-channels.md:3406Credential used in a network call (verify the destination is the intended service)curl -H "Authorization: Bearer $TOKEN" \
-
medium Exfiltration
net-credential-usedocs/04-channels.md:3410Credential used in a network call (verify the destination is the intended service)curl -H "Authorization: Bearer $TOKEN" \
-
medium Dangerous commands
cmd-shell-rcdocs/05-providers.md:860Writes to a shell startup fileecho 'export AWS_PROFILE=default' >> ~/.bashrc
-
medium Dangerous commands
cmd-shell-rcdocs/05-providers.md:861Writes to a shell startup fileecho 'export AWS_REGION=us-east-1' >> ~/.bashrc
-
medium Dangerous commands
cmd-persistencedocs/10-platforms-macos.md:357Persistence mechanism (cron / launchd / scheduled task / autorun registry) (quoted — discussed, not commanded)* `~/Library/LaunchAgents/ai.openclaw.gateway.plist` (or `~/Library/LaunchAgents/ai.openclaw.<profile>.plist`)
quoted -
medium Dangerous commands
cmd-privilegedocs/12-platforms-desktop.md:200Privilege escalation / world-writable permissionssudo tee /etc/wsl.conf >/dev/null <<'EOF'
-
medium Exfiltration
exfil-read-secret-filesdocs/13-deploy.md:224Reads credential / secret files (Dockerfile instruction (build context, not runtime exfiltration))COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
Dockerfile -
medium Dangerous commands
cmd-privilegedocs/13-deploy.md:473Privilege escalation / world-writable permissionscurl -fsSL https://get.docker.com | sudo sh
-
medium Exfiltration
exfil-read-secret-filesdocs/13-deploy.md:618Reads credential / secret files (Dockerfile instruction (build context, not runtime exfiltration))COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
Dockerfile -
medium Dangerous commands
cmd-pipe-to-shelldocs/13-deploy.md:1277Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-shell-rcdocs/13-deploy.md:1611Writes to a shell startup fileecho 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
-
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/13-deploy.md:2058Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://tailscale.com/install.sh | sh
-
medium Dangerous commands
cmd-pipe-to-shelldocs/13-deploy.md:2069Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-privilegedocs/13-deploy.md:2358Privilege escalation / world-writable permissionssudo chmod 600 /swapfile
-
medium Dangerous commands
cmd-privilegedocs/13-deploy.md:2363Privilege escalation / world-writable permissionsecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
-
medium Dangerous commands
cmd-privilegedocs/13-deploy.md:2366Privilege escalation / world-writable permissionsecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
-
medium Dangerous commands
cmd-pipe-to-shelldocs/13-deploy.md:2375Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/13-deploy.md:2432Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://tailscale.com/install.sh | sh
-
medium Dangerous commands
cmd-privilegedocs/13-deploy.md:2505Privilege escalation / world-writable permissionsecho 'gpu_mem=16' | sudo tee -a /boot/config.txt
-
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/13-deploy.md:2721Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
-
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/13-deploy.md:2772Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://tailscale.com/install.sh | sh
-
medium Risky intent
intent-wallet-secretsdocs/16-security.md:461Handles crypto-wallet secrets (seed / mnemonic / private key) — a classic stealer target/(wallet|seed phrase|mnemonic|crypto)/i
-
medium Dangerous commands
cmd-pipe-to-shelldocs/19-troubleshooting.md:426Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/19-troubleshooting.md:450Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/19-troubleshooting.md:557Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/19-troubleshooting.md:561Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
vendor-host -
medium Dangerous commands
cmd-pipe-to-shelldocs/19-troubleshooting.md:590Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host)curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
vendor-host -
medium Dangerous commands
cmd-shell-rcdocs/19-troubleshooting.md:852Writes to a shell startup fileecho 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
-
medium Dangerous commands
cmd-pipe-to-shell-known-hostdocs/19-troubleshooting.md:1492Pipe-to-shell installer from a well-known host (still executes remote code)curl -fsSL https://tailscale.com/install.sh | sh
-
low Dangerous commands
cmd-privilegedocs/02-installation.md:1169Privilege escalation / world-writable permissions (quoted — discussed, not commanded)* If `agents.defaults.sandbox.browser.noSandbox` is set, `--no-sandbox` and `--disable-setuid-sandbox` are also appended.
quoted -
low Dangerous commands
cmd-privilegedocs/03-gateway.md:1728Privilege escalation / world-writable permissions (quoted — discussed, not commanded)* plus `--no-sandbox` and `--disable-setuid-sandbox` when `noSandbox` is enabled.
quoted -
low Dangerous commands
cmd-privilegedocs/03-gateway.md:3639Privilege escalation / world-writable permissions (quoted — discussed, not commanded)* `--no-sandbox` and `--disable-setuid-sandbox` when `noSandbox` is enabled.
quoted -
low Dangerous commands
cmd-background-processdocs/03-gateway.md:7420Starts a background / autostarted processsudo systemctl enable --now openclaw-gateway[-<profile>].service
-
low Exfiltration
exfil-webhook-urldocs/04-channels.md:49Webhook / callback URL commonly used for exfiltration (verify the destination) (placeholder value)curl "https://api.telegram.org/bot<bot_token>/getUpdates"
placeholder -
low Secrets in code
secret-password-literaldocs/04-channels.md:4255Hard-coded password / key literal (may be an example) (placeholder value)accessToken: "oaut…...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
placeholder -
low Secrets in code
secret-password-literaldocs/04-channels.md:4299Hard-coded password / key literal (may be an example) (placeholder value)accessToken: "oaut…...",
placeholder -
low Secrets in code
secret-password-literaldocs/04-channels.md:4351Hard-coded password / key literal (may be an example) (placeholder value)accessToken: "oaut…...",
placeholder -
low Secrets in code
secret-password-literaldocs/04-channels.md:4357Hard-coded password / key literal (may be an example) (placeholder value)accessToken: "oaut…...",
placeholder -
low Secrets in code
secret-password-literaldocs/04-channels.md:4508Hard-coded password / key literal (may be an example) (placeholder value)accessToken: "oaut…...",
placeholder -
low Exfiltration
exfil-webhook-urldocs/08-plugins.md:134Webhook / callback URL commonly used for exfiltration (verify the destination) (placeholder value)// publicUrl: "https://example.ngrok.app/voice/webhook",
placeholder -
low Dangerous commands
cmd-privilegedocs/10-platforms-macos.md:1287Privilege escalation / world-writable permissions (quoted — discussed, not commanded)* Remove the override: `sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist`.
quoted -
low Dangerous commands
cmd-shell-rcdocs/13-deploy.md:1938Writes to a shell startup file (detector / deny-list definition)grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
detector -
low Dangerous commands
cmd-shell-rcdocs/13-deploy.md:2460Writes to a shell startup file (detector / deny-list definition)grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
detector -
low Dangerous commands
cmd-background-processdocs/13-deploy.md:2583Starts a background / autostarted processsudo systemctl enable openclaw
-
low Risky intent
intent-offensive-securitydocs/16-security.md:382Offensive-security / dual-use content (legitimate for authorised testing; review intended use)#### T-EX…03: Credential Harvesting
-
low Risky intent
intent-offensive-securitydocs/16-security.md:459Offensive-security / dual-use content (legitimate for authorised testing; review intended use)/(malware|stealer|phish|phishing|keylogger)/i
-
low Dangerous commands
cmd-pipe-to-shelldocs/18-reference.md:1176Downloads and executes remote code from an unrecognised host (pipe to shell) (the skill's own vendor host; quoted — discussed, not commanded)* (Optional) Installer E2E (Docker, runs `curl -fsSL https://openclaw.ai/install.sh | bash`, onboards, then runs real tool calls):
vendor-hostquoted
…and 1 more
Files scanned: 22. Evidence is masked. Grey chips explain why severity was lowered.
Against the Agent Skills spec
- note
frontmatter-keyunknown frontmatter key "trigger" - note
frontmatter-keyunknown frontmatter key "source"
Process rating: all ten parameters 51/100
- 0Result and completion. Does not say what the result is
- 0Inputs and preconditions. Does not say what the process needs to start
- 0Progress reporting. Says nothing while it works
- 30Running it twice. 11 mutating operations with no state check
- 40Consistency. Frontmatter name (openclaw) differs from the folder (openclaw-agent-skill)
- 60Tools and files. Uses tools (bash, web, node) that frontmatter does not declare
- 65Failures and branches. 3 branches
- 70When it triggers. States when to use, but not when not to
- 100Steps. 180 steps
- 100Execution cost. Instruction body is 2386 tokens
- medium Safety rules and hard prohibitions inside a skill: they belong in the system prompt, here they protect nothing
Everything here is measured from the skill text rather than judged by a model, so the numbers are checkable. A parameter weighs more when it is a more common reason for the process to stall.
Quality signals
- +5Description has no quoted example phrases that should trigger the skill
- +4Description does not say when NOT to use the skill (false activations)
- +3Output format is not stated: the model decides each time
- +4No input/output examples
- +1No license
- +2Single-language instructions
- +3Description length 471: enough signal without eating the budget
- +4Structure: 24 headings
- +3Step-by-step instructions: 180 items
- +4Reference files are cited in the instructions (20 of 20)
Quality base 70; lint remarks subtract, signals add up to 100. Result: 82.