多代理编排运行时Enderfga/claw-orchestrator

Claw Orchestrator

一个面向编码代理的运行时。将 Claude Code、Codex、Antigravity、Grok Build、OpenCode 或任何自定义 CLI 封装为持久化的可编程会话；在多代理议会中协调它们；运行自主的 Planner / Coder / Reviewer 循环；或者将五个问题的访谈交给一个 Opus 议会，让它在 localhost:19000/forge// 交付一个已部署的 Web 应用。

npm version
CI
License: MIT

编码 CLI 是为终端前的人类设计的。Claw Orchestrator 将它们转变为无头引擎，并在其上叠加一个代理平台：一个包含 78 个工具的 API，可从单次会话调用扩展到完全生成、部署的 Web 应用——可通过 CLI、OpenClaw 网关、模型上下文协议（Model Context Protocol）访问，或直接从 TypeScript 调用，并可通过内嵌的三标签仪表盘查看。

https://github.com/user-attachments/assets/fbd2b0ea-28d8-4387-9894-c29cf15ba030

Control · Council · Autoloop · Ultraapp — 35 秒内的四个乐章

功能特性

| 能力                        | 功能说明                                                                                                                                                                                                                                                                                                                                                                                                                                  | 参考                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| 持久会话     | 长期运行的编码代理在请求之间保持存活，并具有完整的上下文、工具、模型和工作树控制。                                                                                                                                                                                                                                                                                                                                | sessions.md           |
| 多引擎运行时    | 一个接口统一接入 Claude Code、Codex、Antigravity (agy)、Grok Build、OpenCode 以及任意自定义 CLI。                                                                                                                                                                                                                                                                                                                                | multi-engine.md   |
| 会话交接         | 将实时对话转移到另一个引擎或模型——把卡住的 Claude 会话转入 Codex，把昂贵的模型换成更便宜的。新会话在同一工作区中从旧会话停止的地方继续；旧会话继续运行。                                                                                                                                                                                                     | sessions.md           |
| 多代理委员会     | 在隔离的 git 工作树中并行运行的代理，通过投票达成共识，直到它们一致。                                                                                                                                                                                                                                                                                                                                                          | council.md             |
| 扇出                 | 在 N 个引擎/模型代理上并行运行一个任务并收集它们的答案，可选进行综合汇总——跨引擎的 best-of-N / 多视角原语（无轮次或工作树）。                                                                                                                                                                                                                                                                                                   | tools.md                 |
| ultracode               | session_start({ ultracode: true }) 让 Claude 编排动态 JS 工作流，并按任务扇出到子代理（Claude 引擎）。                                                                                                                                                                                                                                                                                                     | tools.md                 |
| Autoloop                | 三代理自主工作区迭代，Planner、Coder 和 Reviewer 可独立选择引擎/模型。与 Planner 对话；它会将 Coder + Reviewer 生成到一个自我迭代的子循环中，并在回归、目标命中或决策点时向你推送。                                                                                                                                                                        | autoloop.md           |
| Ultraapp                | 一个三代理 Opus 委员会将五问访谈转化为已部署的 Web 应用——Tailwind UI、BYOK、文件队列运行时、冒烟测试，全部实时运行在 localhost:19000/forge//。                                                                                                                                                                                                                                                      | ultraapp.md           |
| Embedded Dashboard      | 用于 Autoloop、Council 和 Forge 的三标签 UI，带有侧边栏生命周期控制、每次运行的实时事件流，以及通过 /login 重定向实现的基于 cookie 的认证。                                                                                                                                                                                                                                                                               | dashboard.md         |
| OpenAI-Compatible Proxy | POST /v1/chat/completions 将 OpenAI 请求转换为原生 Anthropic、OpenAI 和 Google 调用，并以 OpenAI 格式流式返回响应。将任何 OpenAI-SDK 客户端指向该编排器，而无需更改调用点。                                                                                                                                                                                                                                           | openai-compat.md |
| 持久运行内核      | 基于 agent / fanout / council / verifier / human_gate / router / subflow / autoloop / ultraapp_* 节点的声明式工作流。每一次状态转换都会被检查点保存，因此一次运行能够在进程重启后存活，并在节点边界处恢复。重试、按节点超时、取消、引导和有界循环都由内核提供，而不是来自五个手写的状态机。                                             | workflow.md           |
| 验证平面      | 由运行时自身执行的验收契约——命令、HTTP 探测、截图、差异策略、文件断言——在磁盘上生成证据包。携带契约的运行除非通过，否则无法达到 completed，而没有契约的运行会以 unverified 完成，而不是声称成功。契约所运行的测试以运行启动时的状态为准，因此运行无法通过编辑测试来通过。                | verification.md   |
| 运行账本与支出上限 | 每个引擎上的每一轮都会追加到持久的 JSONL 账本中——引擎、模型、token、成本、时长，以及它所属的 council/fanout/autoloop——重启后可用 clawo runs 查询。行中同时携带引擎的自我报告（ok）和运行时自身的测量结果（verified），二者分开保存。maxBudgetUsd 由运行时强制执行，因此上限在 Codex、Grok、agy 和 OpenCode 上也同样有效，而不仅仅是 Claude Code。 | observability.md |

完整的 78 个工具接口在 tools.md 中列举。

快速开始

npm install -g @enderfga/claw-orchestrator
clawo serve   # dashboard at http://127.0.0.1:18796/dash

import { SessionManager } from '@enderfga/claw-orchestrator';

const manager = new SessionManager();
await manager.startSession({ name: 'fix-tests', engine: 'claude', cwd: '/project' });
const result = await manager.sendMessage('fix-tests', 'Fix the failing tests');

集成

独立 CLI

clawo serve                                            # dashboard + HTTP server on :18796
clawo session-start fix-tests --engine claude --cwd .  # start a session
clawo session-send fix-tests "Fix the failing tests"   # send into it

每条命令都在 cli.md 中有文档说明。

OpenClaw 插件

curl -fsSL https://raw.githubusercontent.com/Enderfga/claw-orchestrator/main/install.sh | bash

通过 npm 安装，在 ~/.openclaw/openclaw.json 中注册插件，重启网关。所有 78 个工具对每个 OpenClaw agent 都可用。

模型上下文协议服务器

npm install -g @enderfga/claw-orchestrator   # clawo-mcp is now on PATH
将 clawo-mcp 注册到任何兼容 MCP 的宿主：Hermes Agent、Claude Desktop、Cursor、Cline、Continue、Zed、Windsurf、Goose 等。各宿主的 stdio 配置片段以及用于严格控制工具预算的 CLAWO_MCP_TOOLS 允许列表见 mcp.md。

Agent Client Protocol Agent

clawo acp        # 或专用二进制文件：clawo-acp

MCP 将工具提供给 agent；ACP 则让你成为 agent。clawo acp 通过 stdio 使用
Agent Client Protocol，因此 Zed、JetBrains、
Neovim、Emacs、VS Code ACP 扩展——或通过其 subagent-acp provider 使用的 dsh——
都可以将 Claw Orchestrator 作为其编码 agent 来驱动。

该生态系统中的其他每个 agent 都是单一 agent。而这一个是一支舰队：模型
选择器按引擎分组，因此一个下拉菜单可同时容纳 Claude、Codex 和 Grok 模型，
切换它即可在会话中途切换引擎，并且 /council、/ultraplan 和
/ultrareview 可从聊天框中运行多 agent 编排。设置、dsh YAML
块以及取消和权限限制见
acp.md。

引擎兼容性

| 引擎        | CLI        | 测试版本       |
| ----------- | ---------- | -------------- |
| Claude Code | claude   | 2.1.274        |
| Codex       | codex    | 0.154.0        |
| Antigravity | agy      | 1.2.5          |
| Grok Build  | grok     | 1.0.34         |
| OpenCode    | opencode | 1.18.31        |
| 自定义 CLI  | 任意       | —              |

任何作为子进程运行的编码 CLI 都可以接入为自定义引擎——见 multi-engine.md。

引擎表如何保持真实

上述版本并非手动输入——它们是每周扫描最近一次运行的结果。scripts/sweep.ts
测量每个核心引擎的已安装、已固定和上游版本，将包装器
传递的标志与二进制文件的 --help 进行差异比对，通过真实包装器类运行一次实时回合，并
对 ACP 和 MCP 入口点进行冒烟测试。它内部没有 LLM，因此报告包装器
损坏的东西不会共享包装器的故障模式。

scripts/sweep-workflow.json 将其包装为该
项目自身内核上的持久运行：验证器 → 路由器 → 在 sweep/ 分支上起草对齐方案的 agent → 人工门禁。这就是
本项目所实践的递归自我改进的有界形式——循环进行测量、提议和
验证；由人合并。编排器有意从不无人值守地编辑自己的代码：
恢复路径必须比它所恢复的东西更简单。其首次脚本化运行发现了一个引擎已悄然
丢弃的默认模型，而三周的手动扫描都忽略了这一点。

贡献

见 CONTRIBUTING.md。提交前运行 npm run build && npm run lint && npm run format:check && npm run test。

许可证

MIT——见 LICENSE。