核心用法
kilocli-coding-agent 是一个将 Kilo CLI 以后台进程方式集成到 OpenClaw 工作流的技能。它采用「workdir + background」模式,让 AI 编程代理在隔离目录中专注执行任务,避免干扰主环境。
典型场景
| 场景 | 命令模式 | 说明 |
|------|---------|------|
| 代码生成/构建 | `kilo run --auto "..."` | 全自动模式,自动批准变更 |
| PR 审查 | `kilo run "Review current branch against main"` | 无特殊参数,需配合 git diff |
| 批量审查 | 并行启动多个 background 进程 | 配合 `process action:list` 监控 |
| 交互式会话 | tmux 模式 | 需要 TTY 的复杂任务 |
关键设计
- 工作目录隔离:通过
workdir:限定代理可见范围,防止读取无关文件(如soul.md) - 安全审查机制:⚠️ 严禁在
~/Projects/openclaw目录运行 PR 审查,必须使用临时克隆或 git worktree - 并行执行:利用
git worktree创建隔离分支,可同时运行 5+ 个修复任务
显著优点
1. 生产级自动化:支持全自动代码生成、测试、提交、推送全流程
2. 并行批处理:可同时审查多个 PR 或修复多个 issue,大幅提升效率
3. 环境隔离:workdir + worktree 双重隔离,避免分支冲突和文件污染
4. 监控友好:通过 process action:log/poll 非侵入式查看进度
潜在缺点与局限
1. 外部依赖重:需预装 Node.js、Kilo CLI、GitHub CLI、tmux,配置门槛较高
2. Token 消耗:全自动模式下 AI 可能产生大量 API 调用
3. 无内置沙箱:仅靠目录隔离,恶意代码仍有执行风险
4. 状态同步延迟:background 模式需轮询检查完成状态
适合人群
- 需要批量处理 PR 的开源维护者
- 希望自动化代码生成的开发者(原型开发、脚手架搭建)
- 已有 Kilo CLI 使用经验,希望集成到 OpenClaw 工作流的高级用户
常规风险
| 风险 | 缓解措施 |
|-----|---------|
| 误操作 live 仓库 | 严格遵守「never in ~/openclaw」规则 |
| 代理失控循环 | `--auto` 模式谨慎使用,保留日志审查 |
| Token 泄露 | `GITHUB_TOKEN` 通过环境变量注入,不硬编码 |
| 资源耗尽 | 并行任务建议控制在 CPU 核心数范围内 |