Agi Terminal Helper

🖥️ 沙箱优先的安全终端执行手册

OpenClaw exec 工具的安全使用手册,强调沙箱优先、显式确认、调试工作流,降低终端命令执行风险

收藏
6.7k
安装
1.4k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用途

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 启用无模型介入的原生执行,复杂场景则遵循本手册的"声明→预览→确认"三步流程。

Agi Terminal Helper 内容

手动下载zip · 2.7 kB
SKILL.mdtext/markdown
请选择文件