OpenRig：开源本地多AI编码智能体编排框架

OpenRig 是什么

OpenRig 是一款开源本地多AI编码智能体编排框架，由 mvschwarz 开发，开源协议为 Apache-2.0，基于 TypeScript 构建。

OpenRig 的核心设计思想：A harness wraps a model. A rig wraps your harnesses.。harness 负责封装单个AI模型会话，rig 将多个 harness 组合，构建具备协作能力的多智能体团队。它不提供大模型本身，只作为控制编排层，把多款编码类AI代理组装在一起协同工作，底层依托 tmux 托管所有AI会话，实现多编码智能体的持久化运行、状态快照与故障恢复。

功能特色

1. YAML 声明式定义智能体拓扑
   通过 YAML 配置文件，自定义智能体角色、分组、智能体之间通信链路，搭配 culture 全局规则文件，实现“代理即配置”，无需修改代码即可调整多智能体团队结构。

2. 基于 tmux 托管会话集群
   依靠 tmux 创建、管理每一个AI会话，无需额外消息中间件。支持 rig up 一键拉起整套智能体集群，同时支持工作快照保存、异常中断恢复，重启环境后还原完整多代理工作现场。

3. 完整多端交互组件栈
   内置守护进程 daemon、CLI 命令行工具、MCP Server，同时提供 React WebUI 网页界面与 TUI 终端界面，可视化查看所有智能体实时运行状态，便于调试。

4. 异构多模型混合协作
   单个Rig集群内可同时接入不同编码AI代理，例如 Claude Code、Codex，让不同特性的编码AI分工协作，共同完成软件开发任务。

5. 灵活启停与安全管控
   支持集群暂停、快照、恢复操作；WebUI 默认关闭，可手动开启，支持配置访问白名单，降低暴露风险。

技术细节

• 开发语言：TypeScript

• 运行环境：Node.js 22 / 24

• 底层依赖：tmux（会话管理核心）

• 支持系统：macOS、Linux；原生Windows不支持，WSL2 未经过充分测试

• 开源协议：Apache-2.0

• 交付形式：npm 发布 @openrig/cli 包，以CLI为主要入口，配套后台守护服务与前端可视化界面

• 架构模型：主编排层（Rig）→ 多个会话封装层（Harness）→ 底层大模型API。所有智能体会话隔离在独立tmux窗口，会话之间按照YAML定义的拓扑完成消息流转。

• 外部依赖说明：OpenRig 仅做调度编排，模型调用会直接向对应模型服务商发起请求，会产生对应平台API费用。项目处于早期迭代阶段，接口存在不兼容变更风险。

应用场景

1. 多智能体软件开发团队模拟
   搭建分工编码智能体，架构设计、代码编写、单元测试、代码评审由不同AI代理分别承担，协同完成中小型项目开发。

2. 本地AI智能体实验调试
   在本地快速迭代多Agent拓扑配置，测试不同角色编码AI之间协作逻辑，保存实验快照，方便反复调试对比效果。

3. 私有化编码工作流编排
   在本地服务器部署整套多AI编码集群，代码与会话数据保留在本地环境，不强制中转第三方平台，满足本地研发实验需求。

4. AI工具链集成研究
   对接MCP协议，把多编码智能体嵌入现有开发工具链，用于自动化代码重构、批量代码迁移任务。

使用方法

1. 安装依赖

环境准备：安装 Node.js 22 或 24，同时安装 tmux。
全局安装 OpenRig CLI：

npm install -g @openrig/cli

2. 编写Rig拓扑配置

新建 YAML 配置文件，定义智能体角色、分组、通信规则，可选编写 culture 全局规则文件，约束整个智能体团队行为规范。

3. 启动多智能体集群

rig up my-rig.yaml

4. 监控与调试

通过 TUI 终端界面或者手动开启 WebUI，查看各个智能体会话运行状态；可执行快照保存，遇到中断后恢复之前的工作现场。

竞品对比

常见问题解答

OpenRig 内置大模型吗？

OpenRig 本身不包含任何大模型，它只是智能体编排调度工具。你需要自行配置接入 Claude Code、Codex 这类编码AI代理，调用模型会产生对应服务商API费用。

Windows系统可以直接运行 OpenRig 吗？

原生Windows不支持，WSL2环境没有经过完整测试，稳定性无法保证，推荐使用 macOS 或者 Linux 系统部署。

OpenRig 的 WebUI 打开后任何人都能访问吗？

新版默认关闭WebUI，手动开启之后，你可以配置访问白名单，限制访问来源，提升服务安全。

升级 OpenRig 新版本会不会导致旧的YAML配置失效？

项目处于早期活跃迭代，API与配置规范存在变动可能性，升级前建议备份好YAML拓扑配置和会话快照。

tmux 是必须安装的依赖吗？

是的。OpenRig依靠tmux管理每一个独立AI会话，没有tmux无法创建、托管、快照恢复多智能体工作现场。

相关链接

• 项目GitHub仓库：https://github.com/mvschwarz/openrig

• npm包地址：https://www.npmjs.com/package/@openrig/cli

• 官方文档站点：https://openrig.dev

总结

OpenRig 是一款基于 TypeScript 开发、Apache-2.0协议开源的本地多编码智能体编排框架，依托 tmux 实现多AI会话托管，通过YAML配置快速搭建异构AI编码协作团队，搭配CLI、TUI与WebUI提供完善的集群管理能力，适合开发者在本地搭建、调试多智能体编码实验环境，为多AI协同软件开发提供轻量化的本地调度方案。