Agi Term Helper

---

name: term description: Fast, explicit terminal execution via OpenClaw exec (direct dispatch; you type the exact command). user-invocable: true disable-model-invocation: true command-dispatch: tool command-tool: exec command-arg-mode: raw metadata: { "openclaw": { "emoji": "🧰", "os": ["darwin","linux","win32"] } }

---

/term — direct terminal execution (exec dispatch)

/term is a power-user shortcut: whatever you type after /term is forwarded as-is to OpenClaw’s exec tool.

This is intentionally *“manual mode”*:

You (the user) provide the exact shell command.

OpenClaw does not rewrite, expand, or “helpfully” change it.

It’s useful when you want quick, deterministic terminal actions without a planning loop.

How dispatch works (important)

OpenClaw supports command-dispatch: tool skills. When you run:

/term ls -la

the raw argument string (ls -la) is forwarded to the configured tool (exec) without extra parsing. In tool-dispatch mode, OpenClaw invokes the tool with params shaped like:

{ command: "", commandName: "", skillName: "" }

See the Skills docs section on command-dispatch, command-tool, and command-arg-mode. :contentReference[oaicite:10]{index=10}

When to use /term vs normal “agent runs”

Use /term when:

You already know the exact command you want.

You want a quick read-only check (files, git status, grep).

You are debugging OpenClaw itself (skills folder, logs, Peekaboo bridge status).

Prefer normal agent flow when:

You want the model to decide the best approach.

The task may need multiple steps, safety checks, or file edits.

Safety model (read this once, then follow it)

/term is equivalent to letting an assistant type into your terminal. Good defaults:

1) Prefer read-only commands unless you *mean* to change state. 2) Avoid secrets in command lines (tokens, API keys, cookies). 3) Avoid remote execution one-liners: - no curl ... | sh - no “download and execute” pipelines 4) If the command could delete or overwrite files, slow down and double-check paths.

Host + sandbox notes

Your actual execution environment depends on how you invoke exec in your setup (sandbox vs host). Also note: when a session is sandboxed, environment variables are not automatically inherited by the container; you must inject them via sandbox env settings or bake them into the image. :contentReference[oaicite:11]{index=11}

Practical examples

Quick inspection (safe, read-only)

/term pwd

/term ls -la

/term git status

/term rg -n "TODO|FIXME" .

Debug Peekaboo bridge discovery (macOS)

/term peekaboo bridge status --verbose

If the output shows “no such file or directory” for all candidates and “Selected: local (in-process)”, you likely have no bridge host running (see troubleshooting below).

One-liners for structured output

If you want JSON output for parsing:

/term python -c 'import json,platform; print(json.dumps({"py":platform.python_version()}))'

Troubleshooting

“command not found”

The tool runs in whatever PATH your OpenClaw runtime provides. If you rely on Homebrew, ensure the runtime sees /opt/homebrew/bin.

“permission denied” / macOS privacy prompts

Some tools (screen capture / UI automation) require Screen Recording / Accessibility. Those permissions are per-process context on macOS; using PeekabooBridge is often the reliable path for automation.

I need richer guidance and guardrails

Install/use the companion skill terminal-helper (model-invocable) which teaches safe patterns, confirmations, and runbooks.

“command not found”

The tool runs in whatever PATH your OpenClaw runtime provides. If you rely on Homebrew, ensure the runtime sees /opt/homebrew/bin.

“permission denied” / macOS privacy prompts

Some tools (screen capture / UI automation) require Screen Recording / Accessibility. Those permissions are per-process context on macOS; using PeekabooBridge is often the reliable path for automation.

I need richer guidance and guardrails

Install/use the companion skill terminal-helper (model-invocable) which teaches safe patterns, confirmations, and runbooks.