Claw Orchestrator
把 Claude Code、Codex、Antigravity 等编码 CLI 变成可编程的常驻引擎，统一编排持久会话、多智能体议会与自治循环。
- Star 数
- ★ 580
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 开始前需要
- 典型场景
- 需要在脚本或后端服务中以 headless 方式驱动 Claude Code 或 Codex 的开发者，要求会话跨请求保持上下文。
- 主要局限
- 强依赖底层编码 CLI：必须安装并维护 claude、codex、agy、grok 或 opencode 之一，各引擎有已测版本要求（如 claude 2.1.260、codex 0.153.2）。
- 源码审查
- 54/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Claw Orchestrator 是一个编码智能体运行时，把面向人类终端的编码 CLI（Claude Code、Codex、Antigravity、Grok Build、OpenCode 及任意自定义 CLI）封装为持久化、可编程的会话。它提供 77 个工具的 API，可从单次会话调用扩展到完整生成并部署的 Web 应用。用户可以通过 CLI、OpenClaw 网关、MCP 服务器、ACP 智能体或 TypeScript SDK 调用它，并通过内嵌的三标签仪表盘查看运行状态。核心原语包括多智能体议会（并行智能体在隔离 git worktree 中投票达成共识）、Planner/Coder/Reviewer 自治循环（Autoloop）、跨引擎 Fan-out，以及把五问访谈变成已部署应用的 Ultraapp。运行内核把 agent/fanout/council/verifier/human_gate 等节点组织为声明式工作流，状态转换均被检查点化，进程重启后可在节点边界恢复。每次调用被追加到持久 JSONL 运行账本，记录引擎、模型、token、成本与时长，且运行时强制执行 maxBudgetUsd 支出上限。
安装后运行 clawo serve 即可在 127.0.0.1:18796/dash 启动仪表盘和 HTTP 服务器。通过 SessionManager 类或 CLI（clawo session-start / session-send）创建命名持久会话，指定引擎、模型、工作目录和 worktree。council 能力在隔离 git worktree 中并行运行多个智能体并投票直到达成共识；fanout 把同一任务分发到 N 个引擎/模型智能体并可选做综合；ultracode 让 Claude 编排动态 JS 工作流并按任务扇出到子智能体。Autoloop 让 Planner 与其派生的 Coder、Reviewer 形成自迭代子循环；Ultraapp 由三智能体 Opus 议会把五问访谈变成部署在 localhost:19000/forge/<slug>/ 的 Tailwind Web 应用。验证平面执行验收契约（命令、HTTP 探测、截图、diff 策略、文件断言）并生成证据包——带契约的运行未通过不能标记 completed，无契约的运行标记为 unverified。POST /v1/chat/completions 提供 OpenAI 兼容代理；clawo-mcp 暴露 MCP 服务器；clawo acp 让编辑器通过 Agent Client Protocol 把它当作编码智能体驱动。
- 需要在脚本或后端服务中以 headless 方式驱动 Claude Code 或 Codex 的开发者，要求会话跨请求保持上下文。
- 需要对同一方案做跨模型交叉验证的工程师，用 council 或 fanout 在隔离 worktree 中并行运行多个引擎并取共识或最优答案。
- 希望一个自治循环持续迭代代码库的团队，Planner 主导对话，Coder/Reviewer 在回归、达标或决策点时回报。
- 想把编码智能体接入 MCP 宿主（Claude Desktop、Cursor、Zed、Cline 等）或让 Zed/JetBrains/Neovim 通过 ACP 直接调用它的用户。
- 已使用 OpenAI SDK 的项目，希望通过指向 /v1/chat/completions 透明切换底层 Anthropic/OpenAI/Google 模型而不改调用点。
- 需要成本可审计的团队，通过 clawo runs 查询每次调用的 token、费用与归属，并用 maxBudgetUsd 设置硬性支出上限。
如何安装或部署这个 Agent？
前置条件：Node.js/npm 环境，以及至少一个受支持的编码 CLI（claude、codex、agy、grok、opencode）或任意可作子进程运行的自定义 CLI。全局安装：npm install -g @enderfga/claw-orchestrator。之后 clawo-mcp 会进入 PATH；OpenClaw 插件可用 curl -fsSL https://raw.githubusercontent.com/Enderfga/claw-orchestrator/main/install.sh | bash 安装，它会注册插件到 ~/.openclaw/openclaw. 并重启网关。
如何使用这个 Agent？
启动服务：clawo serve，仪表盘位于 http://127.0.0.1:18796/dash。CLI 会话：clawo session-start fix-tests --engine claude --cwd .，然后 clawo session-send fix-tests "Fix the failing tests"。TypeScript：import { SessionManager } from '@enderfga/claw-orchestrator'; await manager.startSession({ name: 'fix-tests', engine: 'claude', cwd: '/project' }); 再调用 manager.sendMessage('fix-tests', '...')。其他入口：clawo acp（或 clawo-acp）以 ACP 方式被编辑器驱动；将 clawo-mcp 注册到任意 MCP 宿主；OpenAI 兼容端点为 POST /v1/chat/completions。
这个 Agent 有哪些优点和局限？
- 真正的多引擎运行时：一个接口统一 Claude Code、Codex、Antigravity、Grok Build、OpenCode 与任意自定义 CLI，且可在会话中途切换引擎。
- 带检查点的持久运行内核：verifier、human_gate、router 等节点构成的工作流可在进程重启后于节点边界恢复，重试、超时、取消、转向内建于内核。
- 验证平面与支出上限由运行时强制：带验收契约的运行不通过不能标记 completed，maxBudgetUsd 对 Codex、Grok、agy、OpenCode 同样生效。
- 四种集成入口（CLI、OpenClaw 插件、MCP、ACP）覆盖从终端到编辑器的调用路径，并附三标签实时仪表盘。
- 强依赖底层编码 CLI：必须安装并维护 claude、codex、agy、grok 或 opencode 之一，各引擎有已测版本要求（如 claude 2.1.260、codex 0.153.2）。
- 成本随多智能体设计放大：council、fanout 与 Autoloop 会并发调用多个引擎，无预算配置时费用可观。
- Ultraapp 部署边界是本地 localhost:19000/forge/<slug>/，面向本地演示而非生产托管。
- 编辑器 ACP 集成存在文档中声明的取消与权限限制，需要先阅读 acp.md 了解边界。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| Claw Orchestrator 当前 | 54 · 缺口较多 | ★ 580 | 1 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| TAKT 工作流编排器 | 57 · 缺口较多 | ★ 1.4k | 5 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| fx 编程代理 | 63 · 存在缺口 | ★ 3.1k | 4 天前 | Zig | ChatGPT · Codex · OpenAI API |
| Oh My Pi | 54 · 缺口较多 | ★ 33k | 今天 | TypeScript | Codex · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据仅含 README、LICENSE、package. 与 CI 配置，无任何实现源码。正面：MCP 工具白名单（CLAWO_MCP_TOOLS）、运行时强制的 maxBudgetUsd、验收契约阻止未验证运行标记 completed、sweep 流程含人工合并门。扣分：无代码证明最小权限与确认机制的实际实现；推荐 curl | bash 安装脚本是高风险模式；BYOK 与 cookie 登录仅被提及，敏感数据处理无从核查；外部效果（部署应用到本地端口、改写 openclaw 配置、重启网关）描述宏大但无权限边界细节。
正面：引擎版本以'每周 sweep 实测'方式维护，CI 覆盖 Node 22/24、15 分钟超时防挂起，发布流程用 OIDC 可信发布并钉住 npm 11.x（含失败教训注释）。扣分：README 与 package. 的引擎列表互相矛盾（描述提到 Gemini、Cursor Agent，表格是 Antigravity、Grok Build），自洽性受损；失败消息与错误路径无源码可证，仅有 verified/unverified 的概念区分。
正面：受众（MCP/ACP/OpenClaw 宿主、独立 CLI、TypeScript）与场景覆盖广，能力边界有验收契约、预算上限、人工门等机制，环境要求明确（Node>=22、各引擎实测版本表）。扣分：触发精度无证据；文档细节（mcp.md、acp.md 等）在本次证据中缺失，许多声明只能采信而无法核查。
正面：文档结构清晰（按功能拆分引用文件）、安装步骤齐全、clawo/clawo-mcp/clawo-acp 命名一致、MIT 许可证完整且与 package. 一致、维护机制（weekly sweep、CONTRIBUTING、CI）有具体描述。扣分：版本号 7.1.1 但无 CHANGELOG 文件，更新历史不可追溯；文档文件本身未随证据提供，安装之外的细节存疑。
正面：多引擎统一运行时、多代理议会、fan-out、持久化运行内核与验证平面构成真实的差异化价值；JSONL 运行账本区分引擎自报与运行时实测，成本可查。扣分：全部为声明，无源码、测试或执行证据证明 77 个工具与四条动线实际可用；7 个直接依赖较克制，但收益与代价核算无法独立验证。
正面：README 刻意区分声明与测量（sweep 脚本'无 LLM'、ledger 的 ok 与 verified 分列、human gate 的'循环测量、提议、验证；人来合并'），事实与推断分离意识强。扣分：所有关键能力声明指向 skills/references/ 下未提供的文档，无法追溯；除 package. 与 CI 外，几乎没有第二来源可交叉印证 README 的核心声明。
- 推荐 `curl -fsSL ... | bash` 安装方式会在未经审查的情况下以用户权限执行远程脚本，建议改用 npm 安装并先审计脚本内容。
- 本次审查未包含任何实现源码或引用文档，77 工具、议会、ultraapp 等全部核心能力均为 README 声明，未经静态代码核实，更未经执行验证。
- 发布者为未验证身份（npm: @enderfga），供应链信任需自行评估；安装前核对包完整性与 provenance。
- 该产品会驱动多个编码代理对本地文件、git worktree 与本地端口部署产生实际副作用，使用前应在隔离环境中限定其文件系统与网络权限。
- README 与 package. 对支持的引擎列表描述不一致，实际能力范围请以运行实测为准。