
原站提供的展示图片。
claw-orchestrator 面向需要协调多个编程代理的开发者。它通过统一接口管理不同引擎,让任务能够持续运行、记录过程,并依据预先声明的检查结果判断是否完成。
用途与定位
claw-orchestrator 是一个无界面的运行时,用于在同一套 API 下运行 Claude Code、Codex、Antigravity、Grok Build、OpenCode,以及符合 Agent Client Protocol 的代理。它把任务组织为可持续的会话和工作流,而不是只执行一次命令。每次运行都会记录所用模型、令牌数量和成本,并将状态变化保存下来。
它的核心判断依据是验收契约:使用者声明需要执行的命令、HTTP 探测、截图、差异策略或文件断言,运行时负责执行检查并读取退出结果。只有检查通过,运行才会被判定为已验证;结果也可能是已否定或未验证。
适用场景
当一个代码问题需要由不同编程代理尝试,或需要同时比较多个引擎的处理结果时,可以使用 fan-out 一次发起多个运行。session handoff 可将正在进行的会话转交给另一个引擎,并继续使用同一工作区。
对于较长的目标,goal 工作流可以让 Codex 在一个线程上持续运行,并在进程崩溃、暂停、使用限制或容量错误后尝试恢复。多个代理也可以分别在各自的项目副本中并行工作,适合需要独立修改和比较结果的任务。
准备与上手
运行环境需要 Node 22 或更高版本,并且至少安装并登录一个支持的引擎命令行工具,包括 claude、codex、agy、grok 或 opencode。安装运行时后,可以启动本地服务和仪表盘,再通过 CLI 创建任务。任务通常包含待处理的问题、所选引擎以及一个或多个检查条件。
运行完成后,可以查看检查为何失败、哪些文件发生变化,以及最近运行中每个引擎的模型、令牌、成本和判定结果。运行时会将访问令牌写入用户目录中的配置位置,浏览器首次访问仪表盘时需要使用该令牌登录。
主要功能
项目提供 CLI 和本地仪表盘,也能作为 MCP 服务器供 Claude Code、Claude Desktop、Cursor、Cline、Continue、Zed、Windsurf、Goose 和 Hermes Agent 使用。它还提供 ACP agent、OpenAI 兼容接口、TypeScript SDK 以及 OpenClaw 插件,便于从编辑器、脚本或自有服务接入。
运行内核支持恢复、重试、超时、取消和调整任务。每个状态转换都会被检查点记录,因此进程退出后可以继续运行。运行时还提供按引擎记录的成本账本,并可通过预算上限约束每个引擎的花费。
验收契约与代理执行过程分离,代理不能直接修改运行时用于判断结果的检查。检查证据会保存在磁盘上,便于回看每次运行的判定依据。
可确认的限制
使用前必须具备 Node 22 以上环境,并至少准备一个已安装且完成登录的引擎命令行工具。不同引擎的可用性取决于其自身环境;公开示例中,Grok Build 的一次运行曾因免费层使用额度达到上限而报错。
claw-orchestrator 本身是无界面的底层运行时,通常通过 CLI、仪表盘、MCP、ACP 或兼容接口接入。任务是否被判定为完成取决于预先声明的检查及其结果;没有通过检查时,运行不会被标记为已验证。
运行结果有哪些判定状态?
运行可以被判定为已验证、已否定或未验证;是否完成由运行时执行的验收检查决定。
可以同时使用多个编程代理吗?
可以通过 fan-out 同时运行多个引擎,也可以让不同代理在各自的项目副本中并行工作。