OpenRig 是什么:让多个编程 Agent 协作且可被人监督
部署 OpenRig:实例状态与 Provider 配置要分开看
在启动席位前安排受控的工作站或共享主机试点
你将学会
- 找出状态和资源
- 固定运行环境
- 先设计停机和恢复
开始前需要
- 支持的主机上安装 Node 22 或 24 与 tmux
- 一个可用 Provider 账号及可丢弃仓库
把第一次 owner/checker 运行变成可核验的上线依据
先看结论
- OPENRIG_HOME 不能隔离所有 Provider 配置。
- 仓库文档可能领先 npm 发行版。
- 恢复要逐席位检查结果。
找出状态和资源
守护进程把数据库与实例资源放在 `OPENRIG_HOME`,默认通常为 `~/.openrig`。托管会话还会修改目录以外的 Provider 配置和工作区文件。
按 README 列出的路径备份 tmux、Claude 与 Codex 文件。把 `OPENRIG_HOME` 换个目录并不足以隔离试点,因为 hooks 与信任记录仍可能写到别处。
固定运行环境
明确 Node 22 或 24、CLI 发行版本及 tmux 版本。项目提醒仓库文档可能走在 npm 包之前,所以应把 `rig --version` 与实际引用的文档版本对齐。
共享主机上还要确定守护进程账号、Provider 凭据和工作区归谁管理。共用 shell 账号不能自动形成访问隔离,启动前先验证选定 Provider 的登录。
先设计停机和恢复
`rig down --snapshot` 会为以后恢复记录拓扑;`rig up <name>` 可以依据快照或现有数据库状态恢复。恢复报告区分继续、全新启动和失败的节点。
先在可丢弃团队上演练停止与恢复。升级有独立流程,README 明确提醒不要随手把 `rig down` 当成线上席位的升级步骤。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
列出实例、Provider、工作区三类写入路径。
- 2
固定 Node、CLI 和 Provider 版本。
- 3
在可丢弃席位上演练快照与恢复。
可复制示例
试点:
node: 22或24
cli版本: 固定
provider: 已选择且已登录
配置备份: 已验证
恢复演练: 可丢弃团队常见问题
移动 OPENRIG_HOME 就能干净试用吗?
不能。Provider 信任、hooks 与工作区文件可能在该目录之外。
升级前要先停掉所有席位吗?
固定版本的升级说明明确说 `rig down` 不是升级步骤。
资料来源
- OpenRig / README.md来源核查 2026-10-04
- OpenRig / docs/reference/instance-layout.md来源核查 2026-10-04
- OpenRig / docs/reference/host-resources.md来源核查 2026-10-04
- OpenRig / docs/reference/getting-started.md来源核查 2026-10-04
- OpenRig / packages/cli/src/commands/down.ts来源核查 2026-10-04