核心用途
Terminal Helper 是一份针对 OpenClaw exec 工具的专业操作手册,旨在帮助用户在真实工作环境中安全、高效地执行终端命令。它并非泛泛的终端技巧合集,而是围绕 sandbox-first(沙箱优先) 理念构建的系统性指南。
显著优点
1. 安全边界清晰:明确区分沙箱执行与主机执行,沙箱不继承主机 process.env,环境隔离降低污染风险
2. 操作可审计:强制"意图声明+命令预览"模式,每次执行前说明目的、工作目录、读写文件及预期输出
3. 渐进式权限:默认只读探索(pwd、ls、git status 等),写入/安装操作需经确认
4. 场景化手册:提供技能加载故障、Peekaboo 权限问题、ClawHub 同步被拒等实际问题的排查剧本
潜在局限
- 工具链依赖:部分高级功能(如
peekaboo)需特定 macOS 版本及 TCC 授权配置 - 学习成本:严格的确认流程可能拖慢熟练用户的操作节奏
- 平台差异:Windows 与 Unix-like 系统的权限模型差异未深入覆盖
适合人群
- 使用 OpenClaw 进行自动化工作流的开发者
- 需在 CI/CD 与本地环境间保持隔离的工程师
- 对"curl | sh"类安装脚本有安全顾虑的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 环境泄漏 | 沙箱与主机 env 不继承,可能导致依赖遗漏 |
| 权限误判 | `sudo`、系统设置修改需显式确认,但用户可能惯性点击同意 |
| 长任务中断 | 后台+轮询模式若配置不当,可能产生僵尸进程 |
使用建议
优先通过 /term 启用无模型介入的原生执行,复杂场景则遵循本手册的"声明→预览→确认"三步流程。