核心用法
Kilo CLI Coding Agent 是一种基于后台进程（background process）的编程自动化工具封装，主要用于在受控环境中以非交互方式运行 Kilo CLI 编码代理。核心模式是 workdir + background，即指定工作目录后以守护进程方式启动，通过 process 命令监控、轮询和管理会话生命周期。
主要功能模块：
- 自主构建：使用
kilo run --auto模式自动生成代码（如游戏、工具等） - PR 审查：支持单 PR 审查和批量并行审查，可通过
git worktree隔离分支 - 并行问题修复：结合
tmux会话和git worktree实现多 issue 并发处理 - 交互式会话：复杂任务推荐用
tmux模式替代纯后台模式
显著优点
1. 真正的并行能力：可同时启动多个 Kilo CLI 实例处理不同 PR/issue，效率倍增
2. 环境隔离设计：强制要求 workdir 参数，避免代理"乱跑"读取无关文件；配合 git worktree 实现分支级隔离
3. 灵活的工作流：支持从简单命令到复杂多会话编排的多种场景
4. 与 GitHub CLI 深度整合：原生支持 gh pr checkout、gh pr comment 等操作
潜在缺点与局限性
1. 外部依赖沉重：必须预装 npm、kilo、git、gh、tmux 等工具链，且需配置 GITHUB_TOKEN
2. 资源消耗：并行运行多个 Kilo CLI 实例对 CPU/内存有一定要求
3. 调试困难：后台进程出错时需通过 process:log 间接诊断，不如终端直接
4. 版本锁定风险：依赖特定版本的 @kilocode/cli，版本更新可能破坏兼容性
适合人群
- 需要批量处理 GitHub PR 审查的维护者/团队
- 追求"编码代理即服务"、希望自动化代码生成的开发者
- 熟悉 tmux、git worktree 等高级 Git 工作流的高级用户
- 有充足本地资源支持多进程并行的场景
常规风险
1. 敏感信息泄露：⚠️ 严禁在 OpenClaw 自身目录（~/openclaw、~/Projects/openclaw）运行，否则代理会读取内部文档（如 soul.md）并可能外泄
2. 分支冲突/损坏：在运行中的 OpenClaw 仓库直接 checkout 分支会导致实例崩溃，必须使用临时目录或 git worktree
3. 权限风险：GITHUB_TOKEN 泄露可能导致仓库被恶意操作
4. 会话管理失控：未正确 kill 的后台进程可能长期占用资源
5. 自动批准陷阱：--auto 模式会无提示批准所有变更，不适合生产环境关键代码