/term — 直接终端执行（exec 分发）

/term 是一个高级用户快捷方式：你在 /term 后输入的任何内容，都会原样转发给 OpenClaw 的 exec 工具。

该模式被有意设计为“手动模式”：

• 你（用户）需提供精确的 Shell 命令。
• OpenClaw 不会重写、展开或“好心地”修改该命令。
• 当你希望快速、确定性地执行终端操作，且无需规划循环（planning loop）时，此模式非常有用。

分发机制说明（重要）

OpenClaw 支持 command-dispatch: tool 类型的技能。当你运行：

• /term ls -la

原始参数字符串（ls -la）将未经额外解析，直接转发至所配置的工具（exec）。在工具分发（tool-dispatch）模式下，OpenClaw 会以如下结构化参数调用该工具：

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

详见 Skills 文档中关于 command-dispatch、command-tool 和 command-arg-mode 的说明。 :contentReference[oaicite:10]{index=10}

/term 与常规“智能体运行”的使用场景对比

请在以下情况下使用 /term：

• 你已明确知道所需执行的确切命令。
• 你仅需快速执行只读检查（如查看文件列表、git 状态、grep 搜索）。
• 你正在调试 OpenClaw 自身（例如 skills 目录结构、日志、Peekaboo bridge 运行状态）。

建议在以下情况优先采用常规智能体流程（agent flow）：

• 你希望由模型自主判断并选择最优执行路径。
• 任务可能涉及多步骤操作、安全校验或文件编辑等复杂逻辑。

安全准则（请认真阅读一次，并严格遵守）

/term 等效于允许一位助手直接向你的终端输入命令。 推荐默认实践如下：

1. 除非你**明确意图变更系统状态**，否则应优先使用只读命令。
2. 切勿在命令行中暴露敏感信息（如 tokens、API keys、cookies）。
3. 禁止执行远程一键式命令（remote execution one-liners）：
   • 禁用 curl ... | sh
   • 禁用“下载即执行”类管道命令（download-and-execute pipelines）
4. 若命令可能删除或覆盖文件，请务必放慢操作节奏，仔细核对路径。

宿主环境（host）与沙箱（sandbox）注意事项

实际执行环境取决于你在部署中如何配置 exec（运行于宿主系统 vs 运行于 sandbox 容器）。 另请注意：当会话处于 sandbox 模式时，环境变量不会自动继承至容器内；你必须通过 sandbox 的环境变量配置显式注入，或将其预置（bake）到容器镜像中。 :contentReference[oaicite:11]{index=11}

实用示例

快速检查（安全、只读）

• /term pwd
• /term ls -la
• /term git status
• /term rg -n "TODO|FIXME" .

调试 Peekaboo bridge 发现机制（macOS）

• /term peekaboo bridge status --verbose

若输出显示所有候选路径均报 “no such file or directory”，且最终显示 “Selected: local (in-process)”，则表明当前未运行 bridge host 进程（参见下方故障排查部分）。

用于生成结构化输出的一行命令

若你需要 JSON 格式输出以便后续解析：

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

故障排查

“command not found”

该工具运行于 OpenClaw 运行时所提供的 PATH 环境中。若你依赖 Homebrew，请确保运行时环境能识别 /opt/homebrew/bin 路径。

“permission denied” / macOS 隐私权限提示

部分工具（如屏幕录制、UI 自动化）需获得 macOS 的 Screen Recording 或 Accessibility 权限。这些权限在 macOS 上按进程上下文授予；使用 PeekabooBridge 通常是实现自动化任务的可靠方案。

我需要更完善的指导与防护机制

请安装并启用配套技能 terminal-helper（支持模型调用），它可提供安全操作范式教学、交互式确认流程及标准化操作手册（runbooks）。