Claw Orchestrator
把 Claude Code、Codex、Antigravity 等编码 CLI 变成可编程的常驻引擎，统一编排持久会话、多智能体议会与自治循环。
- Star 数
- ★ 603
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要在脚本或后端服务中以 headless 方式驱动 Claude Code 或 Codex 的开发者，要求会话跨请求保持上下文。
- 不适合
- 需要开箱即用、不想安装维护 claude、codex 等底层 CLI 的团队
- 对多智能体并发调用成本敏感、无法配置预算上限的用户
- 需要生产级托管部署的用户，Ultraapp 仅限本地演示
- 源码审查
- 61/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.json 并重启网关。
如何使用这个 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 当前 | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 603 | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| TAKT 工作流编排器 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.4k | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Lody | 63 · 存在缺口 | 自托管服务 | ★ 1.7k | 今天 | TypeScript | Codex · Claude Code |
| fx 编程代理 | 65 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 3.8k | 今天 | Zig | ChatGPT · Codex · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
代码集中由 engine-spawn.ts 启动 CLI，文档说明运行本地服务、token 路径、验收检查和预算账本，工作流也支持取消、恢复及回滚，因此数据流和恢复机制有一定依据。扣分原因：候选能力包括任意自定义 CLI、MCP 工具和部署生成，但样本未充分说明权限收敛、外部副作用确认及敏感数据保护；secret 引用从服务端环境解析也未说明其存储或泄漏防护。仓库作者和发布入口可追溯，但发布者身份未验证。
工作流节点、模板及 README 对运行时验证、持久化和恢复的描述大体一致；CI 文件列出构建、lint、格式和测试步骤。扣分原因：CLI 和多个外部引擎是运行依赖，样本没有展示其可用性保障；虽有超时、重试和状态机制的概述，具体错误对用户如何呈现的证据有限。静态审查不据此宣称测试已执行。
README、技能描述和 package 元数据覆盖终端、脚本、MCP、ACP、SDK、OpenClaw 插件及多引擎场景，用户和常见工作流说明具体。扣分原因：技能触发词清单很宽，可能匹配与此工具无关的普通编码或建站请求；样本只部分说明能力边界，且环境要求主要明确为 Node 22+ 和已登录的引擎 CLI。
README 以功能、运行方式和参考文档组织信息，并提供快速开始、版本兼容表和示例；MIT 许可证、7.20.0 版本及变更日志链接明确。AGENTS.md 是面向贡献者的架构说明而非产品强制指令。扣分原因：安装说明虽有全局 npm 安装和前置条件，但涵盖多种宿主的配置细节分散在未提供的文档中；导出代码仍列有未在当前主选项中介绍的 legacy Gemini/Cursor 引擎；维护者/更新路径可识别但样本未给出明确响应承诺。
运行时把多个 CLI 统一到会话、工作流和验收机制，并把检查结果、账本和预算作为可用输出，解决跨引擎编排与独立验收问题的价值明确。扣分原因：样本展示的结果形式和具体使用收益有限；多进程、多引擎及部署流程带来配置与运行成本，缺少成本对比或适用规模说明。
README 将核心主张链接到验证、工作流、工具等文档；源代码展示工作流模板和节点注册，package/CI 文件补充版本、脚本与依赖信息。扣分原因：样本没有纳入被引用的详细文档或测试实现，CI 配置只能证明定义了检查步骤，不能证明其已通过；README 对演示、兼容性和能力的叙述未处处明确区分记录事实与概括性主张。
- 该工具会启动本机引擎 CLI，并支持任意自定义 CLI；使用前应核对 CLI 权限、工作目录和外部副作用，并避免将不必要的秘密放入服务端环境。
- README 说明的本地服务 token 位于 ~/.openclaw/server-token；样本未展示该 token 的访问控制细节或自定义引擎环境变量的保护方式。
- CI 文件列出测试命令，但本次仅做静态审查，不能据此认定测试已通过或运行结果正确。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/claw-orchestrator)<a href="https://followagents.com/zh/agents/claw-orchestrator"><img src="https://followagents.com/badge/claw-orchestrator.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v7.20.1 v7.20.1 — OpenAI-compat timeout, Planner control errors, CLAUDE_BIN
发布说明摘录
Fixes for OpenAI-compatible request timeouts, rejected Autoloop Planner controls, and CLAUDE_BIN. - OpenAI-compatible requests wait up to 30 minutes for a turn instead of 5 (OPENAI_COMPAT_TURN_TIMEOUT_MS changes it), so a gateway agent with a long reply is no longer cut off and retried. - A rejected Planner control shows in the Autoloop reply, naming the problem for a validation error, and is recorded as a planner_control_error row in decisions.jsonl. (#162, thanks @ajmtrz) - CLAUDE_BIN takes effect for clawo serve and the MCP server. (#163, thanks @wagnerglorenz) …在 GitHub 查看 ↗ -
v7.20.0 v7.20.0 — fan-out agents that run as goals
发布说明摘录
A fan-out agent can now run as a goal, so several agents can each work a copy of a project until it is done. - objective on a fan-out agent (engine claude or codex) runs it as a goal instead of one turn, with a goal node's rules: judged, budgeted, timed out, and resumed after stalls and capacity errors. It runs beside the agents that take one turn. - Resumable — each goal runs in a child run checkpointed on the fan-out node, so a parent that resumes after a crash reattaches to it instead of starting it over. Each result carries the goal's run id and final status. …在 GitHub 查看 ↗ -
v7.19.0 v7.19.0 — a working directory per fan-out agent
发布说明摘录
Several fan-out agents can now write code at once, each in a directory of its own. - cwd per fan-out agent — on fan-out nodes and fanout_start, absolute or relative to the fan-out's directory. Each result records the cwd it ran in, and an unsafe one fails that agent only. - An unknown model is warned about once, not on every priced update. - Gateway models are not priced as Sonnet — under CLAWO_CLAUDE_GATEWAY, a non-Claude model is priced from pricingOverrides, not from another model's rate or the CLI's own figure; without an override its cost is 0. …在 GitHub 查看 ↗
谢谢反馈，我们会据此改进页面。