核心用法
cli-worker 是一个面向开发者的任务委托技能，核心功能是将编码任务交给 Kimi CLI 代理 在 隔离的 git worktree 中执行。典型工作流包括：
1. 任务委托：通过 cli-worker execute "任务描述" 启动异步任务，可选 --constraint 指定约束、--success 定义完成标准
2. 状态追踪：使用 cli-worker status <taskId> 查询执行进度
3. 工作树管理：通过 worktree list/remove 管理隔离环境，cleanup 自动清理过期任务
4. 结果合并：任务完成后可选择合并（git merge openclaw/<taskId>）或丢弃（worktree remove）
显著优点
- 完全隔离：每个任务独立 worktree，避免 git 冲突和状态污染
- 真并行执行：不阻塞主 agent，支持多任务并发
- 生产级工作流：原生支持 CI/CD 场景，可 headless 运行
- 可靠性优于 spawn：规避
sessions_spawn偶发的"零消息"僵死问题
潜在缺点与局限
- 环境门槛高：需手动安装并认证 Kimi CLI（
uv tool install+ OAuth/login），无法自动化 - 非实时交互：适合"下达任务-等待结果"模式，不适合需要多轮对话的复杂协作
- 本地依赖重：依赖 git worktree、Node.js 工具链，云端/容器环境配置复杂
- 无内置重试：任务失败需人工判断重试
适合人群
- 需要 批量并行处理 编码任务的开发者
- 在 CI/CD 流水线 中集成 AI 代码生成的工程团队
- 追求 git 原生工作流、厌恶虚拟环境 hack 的洁癖型用户
- 已在使用 OpenClaw 生态的进阶用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 认证失效 | Kimi CLI OAuth token 过期需重新 `/login` |
| 资源泄漏 | worktree 未清理会累积磁盘占用，建议配置 `--older-than` 自动清理 |
| 合并冲突 | 虽隔离执行，但最终 `git merge` 仍可能冲突，需人工解决 |
| 环境漂移 | 主仓库与子 worktree 的依赖/配置不一致可能导致"在我机器上能跑" |
建议配置
// ~/.openclaw/openclaw.json
{
"worktree": {
"basePath": "/var/openclaw-worktrees"
}
}