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

Claw Orchestrator

面向编程智能体的运行时。把 Claude Code、Codex、Antigravity、Grok Build、OpenCode 或任意自定义命令行包装成可编程的常驻会话；在多智能体议事会里协调它们；跑自主的 Planner / Coder / Reviewer 循环；或者把一段简短的结构化访谈交给 Opus 议事会，让它在 localhost:19000/forge/<slug>/ 交付一个已部署的 Web 应用。

编程命令行是给人坐在终端前用的。Claw Orchestrator 把它们变成无头引擎，再在上面加一层编排：78 个工具，从单会话调用到多智能体运行、再到生成 Web 应用，都能通过命令行、OpenClaw 网关、Model Context Protocol 或直接从 TypeScript 调用，并在内置的三标签仪表盘里看到。

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

Control · Council · Autoloop · Ultraapp — 35 秒演示

功能

| 能力 | 作用 | 参考 |
| 持久会话 | 长期存活的编码智能体，跨请求保持运行，完整掌控上下文、工具、模型与 worktree。 | sessions.md |
| 多引擎运行时 | 一套接口，统一对接 Claude Code、Codex、Antigravity（agy）、Grok Build、OpenCode，以及任意自定义命令行。 | multi-engine.md |
| 会话交接 | 把进行中的对话转到另一个引擎或模型——卡住的 Claude 会话转进 Codex，昂贵的模型换成更便宜的。新会话在同一工作区里接着旧会话停下的地方继续，旧会话照常运行。 | sessions.md |
| 多智能体议事会 | 多个智能体在隔离的 git worktree 中并行工作，投票表决直到达成共识。 | council.md |
| 扇出 | 把一个任务并行分发给 N 个引擎/模型智能体，收集它们的答案，可选再做一轮综合——这是跨引擎的 best-of-N／多视角原语（不涉及轮次或 worktree）。 | 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/<slug>/。 | ultraapp.md |
| Embedded Dashboard | 三标签页 UI，覆盖 Autoloop、Council 和 Forge，带侧边栏生命周期控制、每次运行的实时事件流，以及基于 cookie 的认证，通过 /login 重定向。 | dashboard.md |
| OpenAI-Compatible Proxy | POST /v1/chat/completions 接受 OpenAI 格式的请求，按模型名选定的引擎把它们路由到持久会话，并以 OpenAI 格式流式返回回复。把任何 OpenAI-SDK 客户端或 Web 聊天指向编排器，无需改动调用点。 | openai-compat.md |
| 持久化运行内核 | 声明式工作流，覆盖 agent / fanout / council / verifier / human_gate / router / subflow / autoloop / ultraapp_* 节点。每次状态转换都会写入检查点，所以进程重启后运行仍能存活，并在节点边界处恢复。重试、单节点超时、取消、引导和有界循环都由内核提供。 | workflow.md |
| 验证平面 | 运行时自己执行的验收契约——命令、HTTP 探测、截图、diff 策略、文件断言——在磁盘上产出证据包。带契约的运行只有通过验证才能到达 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

服务器会在 ~/.openclaw/server-token 生成访问 token；打开 http://127.0.0.1:18796/login?token=<token>&redirect=/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');

集成

独立命令行

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 智能体可用。

Model Context Protocol 服务器

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 智能体

clawo acp # or the dedicated binary: clawo-acp

MCP 把工具交给智能体；ACP 让你自己成为智能体。clawo acp 通过 stdio 说 Agent Client Protocol，于是 Zed、JetBrains、Neovim、Emacs、VS Code 的 ACP 扩展——或者 dsh 通过它的 subagent-acp 服务商——都能把 Claw Orchestrator 当作自己的编码智能体来驱动。

模型选择器按引擎分组，所以一个下拉框里同时装着 Claude、Codex 和 Grok 的模型，切换它就等于在会话中途切换引擎；/council、/ultraplan 和 /ultrareview 直接在聊天框里跑多智能体编排。安装步骤、dsh 的 YAML 配置块，以及取消和权限方面的限制，都在 acp.md 里。

引擎兼容性

| 引擎 | 命令行 | 测试版本 |
| Claude Code | claude | 2.1.291 |
| Codex | codex | 0.160.1 |
| Antigravity | agy | 1.3.0 |
| Grok Build | grok | 1.0.46 |
| OpenCode | opencode | 1.18.34 |
| 自定义命令行 | 任意 | — |

任何以子进程方式运行的编码命令行都能接成自定义引擎——见 multi-engine.md。

引擎表如何保持最新

上面这些版本不是手敲进去的——它们是每周扫描最近一次跑出来的结果。scripts/sweep.ts 会测量每个核心引擎已安装、已锁定和上游的版本，把包装器传入的 flag 与二进制的 --help 做 diff，通过真实的包装器类跑一轮实时对话，对 ACP 和 MCP 入口做冒烟测试，并拿 src/models.ts 对照两家服务商公布的价格表。它本身不含模型调用，所以那个报告包装器损坏的检查，不会和包装器共享同一套故障模式。

scripts/sweep-workflow.json 把同一个脚本包装成在这个项目自己的内核上跑的持久化运行：验证器 → 路由器 → 一个在 sweep/<date> 分支上起草对齐方案的智能体 → 人工关卡。由人来审查并合并；编排器不会在无人看管的情况下改自己的代码。

贡献

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

许可证

MIT——见 LICENSE。