核心功能与用法
Claude Code CLI Skill 是 OpenClaw 平台对接 Anthropic 官方 Claude Code 终端工具的桥梁,允许将复杂编程任务委托给 Claude Code 在后台执行。该 Skill 提供两种运行模式:
1. 交互式 PTY 模式(pty:true)
- 用于需要确认、权限提示或人工输入的任务
- 支持前台阻塞执行或后台异步执行(返回 sessionId 供监控)
- 必须配合
--permission-mode acceptEdits防止后台任务因等待确认而挂起
2. 无人值守管道模式(-p 标志)
- 适用于 CI/CD 自动化、批量脚本场景
- 支持结构化 JSON 输出、流式 JSON 输出、预算上限控制(
--max-budget-usd) - 可配合 JSON Schema 验证输出结构
典型应用场景
- 功能开发:后台执行完整功能构建,支持会话恢复与分叉
- PR 审查:克隆到临时目录后使用
--permission-mode plan只读模式安全审查 - 并行修复:利用 Git worktree 同时处理多个 Issue
- 批量迁移:Fan-Out 模式并行处理多文件
- 双角色协作:Writer + Reviewer 并行会话实现自审查
显著优点
1. 原生 Anthropic 工具链:直接调用官方 CLI,非第三方封装,功能完整度最高
2. 会话连续性:支持 --resume、--continue、--fork-session,长任务可断点续跑
3. 精细权限控制:从 default(逐条确认)到 dangerously-skip-permissions(全自动)多级权限模式
4. 动态子代理:通过 --agents 参数内联定义专用子代理,无需磁盘文件
5. 资源监控完善:Process 工具提供 list/poll/log/write/kill 全生命周期管理
6. 安全沙箱感知:明确禁止在 ~/.openclaw/ 工作区运行,防止自修改风险
潜在局限与风险
- PTY 硬性依赖:交互模式必须显式声明
pty:true,否则输出断裂或代理挂起 - 资源竞争:官方建议最多 3-4 个并发会话,过量并行导致性能下降
- 成本不可控:若无
--max-budget-usd,长时间后台任务可能产生高额 API 费用 - 权限模式陷阱:
--dangerously-skip-permissions与bypassPermissions完全绕过安全护栏,需显式警告 - 超时配置敏感:真实开发任务需 1800 秒以上超时,默认超时可能导致任务中途被杀死
- 临时目录管理:PR 审查等场景需手动清理
/tmp克隆目录,存在磁盘泄漏风险
适用人群
- 全栈开发者:需要 AI 辅助完成复杂功能开发、代码重构
- 技术负责人:需要批量审查 PR、并行处理技术债务
- DevOps 工程师:需要无人值守的 CI 集成与代码迁移自动化
- 开源维护者:需要高效处理多 Issue 并行修复与提交
常规风险提示
- 成本风险:Claude Code 按 token 计费,长会话或无预算限制的运行可能产生意外费用
- 数据隐私:代码内容上传至 Anthropic API,需评估代码敏感等级
- 自动提交风险:
acceptEdits模式自动接受文件修改,建议配合 Git 工作区隔离 - 会话僵尸:后台任务异常退出时可能残留进程,需定期
process action:list检查清理