Terminal Helper — OpenClaw exec 的操作手册

此技能并非通用终端提示模板，而是一份针对实际工作区（如你的 /Users/.../clawd 工作区）中有效使用 OpenClaw exec 工具的详细操作手册，重点关注以下方面：

• 沙箱环境与主机环境的执行区别
• 可预测的工作目录设置
• 长时间运行的任务处理
• macOS 上的权限问题（如 Peekaboo、屏幕录制、UI 自动化）
• 避免“意外的 shell 脚本”灾难

OpenClaw 技能从捆绑技能、~/.openclaw/skills 和 <workspace>/skills 加载，其中工作区目录的技能具有优先级。:contentReference[oaicite:12]{index=12}

运行原则（每次都会遵循）

1）执行前明确意图与具体命令

在调用 exec 之前，我会说明：

• 命令的预期目的
• 将在哪个目录下运行
• 可能读取或写入的文件
• 预期输出内容（以便发现异常）

2）默认以只读方式探索

在调试或定位问题时：

• 使用 pwd、ls -la、git status、rg、cat、head、tail 等命令
• 在确认环境状态后，才升级为写入或安装操作

3）对不可信或高变动性任务优先使用沙箱执行

适用于沙箱的场景包括：

• 测试、构建、依赖安装
• 探索未知仓库
• 运行来自第三方的脚本

重要细节：

如果会话处于沙箱环境中，沙箱不会继承主机的 process.env。全局环境变量和 skills.entries.<skill>.env/apiKey 仅适用于主机运行；沙箱环境变量需单独设置。:contentReference[oaicite:13]{index=13}

4）任何高风险操作前必须明确确认

我将要求用户确认以下行为：

• 删除或覆盖文件
• 安装系统级软件包
• 修改 ~/.ssh、钥匙串、浏览器配置文件
• 更改网络或系统设置
• 执行特权命令（如 sudo、launchctl 修改）

执行模式（操作方法）

A）有意识地选择工作目录

在排查 OpenClaw 本身问题时，我将在你的工作区内部操作（例如：/Users/proman/clawd），并明确指出路径。

常用命令示例：

• 检查技能目录：

- ls -la ./skills

- find ./skills -maxdepth 2 -name SKILL.md -print

• 检查 Git 状态：

- git status（若工作区是 Git 仓库）

• 验证二进制是否存在：

- which peekaboo || echo "peekaboo not on PATH"

B）保持命令单一职责

优先使用多个小型命令，而非一个“完成所有”的管道命令。这有助于审查并提升安全性。

C）长时间运行命令：后台执行 + 定期轮询

当支持时，采用短暂停顿后轮询进程会话的方式。

可参考的模式（可自行调整）：

• 启动长时间构建任务：

- exec: make test（带短暂延迟）

• 轮询任务完成状态：

- process: poll（使用返回的会话 ID）

（具体参数名称取决于你的工具接口，但核心模式为：延迟 → 轮询。）

实用操作手册

手册 1：我的技能未加载

1）确认技能位置与加载优先级：

- OpenClaw 优先加载 <workspace>/skills 目录中的技能。:contentReference[oaicite:14]{index=14}

2）验证技能文件夹中包含 SKILL.md 且 frontmatter 格式正确。

3）若已修改文件，请确保监视器已启用：

- skills.load.watch: true 是默认配置。:contentReference[oaicite:15]{index=15}

手册 2：Peekaboo 在终端中正常，但在 OpenClaw 中失败

这通常与 macOS 的 TCC 权限上下文及守护进程行为有关。常见解决方案是启用 OpenClaw.app 中的 PeekabooBridge：

• 设置 → 启用 Peekaboo Bridge :contentReference[oaicite:16]{index=16}

随后验证：

• peekaboo bridge status --verbose 应显示主机（OpenClaw.app）而非 local (in-process)。:contentReference[oaicite:17]{index=17}

手册 3：ClawHub 同步拒绝我的技能文档

ClawHub 具有质量检测机制（基于语言感知的词数统计与启发式规则），会拒绝内容过少或模板化的文档。:contentReference[oaicite:18]{index=18}

修复建议包括添加：

• 具体示例
• 故障排除指南
• 环境说明（沙箱、PATH、权限等）
• 明确的“做什么/为什么/何时/如何”说明，且与该技能紧密相关

我不会执行的操作

• 不会在未经用户明确请求和审查的情况下运行远程“安装脚本”（如 curl | sh）。
• 不会将密钥或敏感信息粘贴或输出到命令中。
• 不会在未确认确切文件路径的情况下进行破坏性更改。

我常使用的快速命令

• pwd
• ls -la
• git status
• rg -n "error|warn|TODO" .
• uname -a
• node -v && python -V

如需直接、无模型干预的执行，请使用 /term。