OpenRig rig export与importAgent团队状态跨实例迁移完整流程【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个把 Claude Code 与 Codex 组合成统一系统的多智能体框架Multi-agent harness。当你要把一支 Agent 团队从一台机器搬到另一台、或从一个工作区复制给同事时核心就是rig export与rig import这对命令前者把正在运行的 RigAgent 团队导出为 YAML 规格文件后者在新实例上导入并重新启动整套团队。本文带你走通这条导出 → 迁移 → 导入 → 验证的完整链路。为什么需要 export/import在 OpenRig 中一个Rig就是一支有明确组织架构的 Agent 团队它由若干Pod小组和Member具体 Agent 节点组成并声明了成员之间的关系谁委托谁、谁观察谁、谁与谁协作。团队的完整状态并不散落在终端里而是被抽象为一份RigSpecYAML 规格——节点、Agent 引用、运行时claude-code / codex / terminal、工作目录、启动动作全部可序列化。这正是跨实例迁移的基础export 是拍下快照从运行中的 daemon 拉取当前 Rig 的规格落盘成rig.yamlimport 是按图纸重建在新实例上解析 YAML完成校验、预检、实例化重新拉起整套团队。第一步rig export 导出团队规格CLI 命令定义在 export.ts用法非常简单rig export rigId -o rig.yaml第一个参数是Rig ID用rig ps查看当前所有 Rig-o / --output指定输出文件路径不传时默认写入rig.yamlexport 会先检查本地 daemon 是否运行未启动时会直接提示不会发出无效请求。导出的内容就是一份标准的 RigSpec YAML例如项目自带演示规格的这种结构version: 0.2 name: demo-rig culture_file: culture.md pods: - id: orch label: Orchestration members: - id: lead agent_ref: local:agents/lead runtime: claude-code完整示例见 demo/rig.yaml它声明了 orch编排、dev开发、rev评审三个 Pod以及delegates_to这类跨 Pod 协作边——这些结构导出后都会完整保留是迁移后团队神似的关键。 小贴士export 失败时先确认 daemon 健康状态rig doctor404 说明 Rig ID 不存在5xx 则看 daemon 日志。第二步在新实例上准备导入环境导入前目标实例需要满足三个条件daemon 已启动——import 与 export 一样依赖本地 daemon 处理校验与实例化Agent 定义可达——RigSpec 中的agent_ref如local:agents/lead指向的 Agent 定义文件要随规格一起拷贝过来演示仓库中的布局是 demo/agents/路径一致或已调整——cwd等相对路径在解析时会基于规格文件所在目录或--rig-root跨机器时注意目标目录是否存在。第三步rig import 的四种姿势导入命令定义在 import.ts同一个命令通过参数提供从轻到重的四种模式建议按顺序逐级执行模式命令作用何时用校验rig import rig.yaml仅校验 YAML 结构拿到文件后的第一道关预检rig import rig.yaml --preflight检查运行环境名称冲突、依赖可用性等实例化前的体检物化rig import rig.yaml --materialize-only [--target-rig id]只建拓扑、不启动会话先搭骨架人工确认后再点火实例化rig import rig.yaml --instantiate完整重建团队并启动所有 Agent正式迁移几个常用选项--target-rig rigId把规格增量物化进已有 Rig如新增一个 Pod而不是创建新团队--rig-root rootPod 感知规格的根目录用于解析相对路径不传时默认取规格文件所在目录--cwd path覆盖所有成员的启动工作目录相对路径会被自动转为绝对路径。CLI 内置了互斥保护--instantiate与--materialize-only不能同用--workspace-only必须搭配--target-rig写错参数会立刻报错并退出不会留下半成品状态。成功实例化后终端会逐节点打印状态并给出接入命令Rig created: demo-rig (rig-xxx) orch.lead: launched dev.impl: launched dev.qa: launched Attach: tmux attach -t orch-leaddemo-rig⏱ 注意--instantiate会等待所有节点就绪CLI 为此内置了 120 秒的长时超时预算成员较多时耐心等它跑完即可。第四步迁移后验证三件套导入完成后用三个命令确认团队完整落地完整操作参考 skills/_canonical/core/ 下的 openrig-user 技能文档rig ps --nodes --rig rigId # 节点是否全部出现 rig status # daemon 与各节点健康度 rig export rigId -o rig2.yaml # 再次导出与迁移前文件 diff 比对第三次导出是黄金验证把迁移前的rig.yaml与迁移后的rig2.yaml做文本对比结构一致即说明团队状态无损迁移。常见报错速查现象原因解决not runningdaemon 未启动先启动 daemonrig up/ 参考启动文档Cannot read file规格文件路径错误检查相对路径改用绝对路径A rig with this name is already running目标实例已有同名 Rig改规格中的name或用--target-rig增量物化Preflightnot ready环境不满足如名称冲突、依赖缺失按输出的 errors 列表逐项修复后重试导入成功但 Agent 找不到定义agent_ref指向的 agent 文件未随迁拷贝 demo/agents/ 这类 Agent 定义目录到相同相对位置小结两条命令完整迁移导出rig export rigId -o rig.yaml—— 把运行中团队的完整规格落盘导入rig import rig.yaml --instantiate—— 在新实例校验、预检后一键重建并启动进阶--materialize-only搭骨架、--target-rig增量合并、--workspace-only只同步工作区声明验证rig ps 二次导出 diff确认状态无损。配合rig bundle把规格 skills 插件打包成.rigbundleOpenRig 的 export/import 让Agent 团队第一次像代码一样可以备份、版本化和跨实例流转。延伸阅读CLI 命令参考docs/as-built/cli-reference.md用户技能文档packages/daemon/assets/plugins/openrig-core/skills/openrig-user/SKILL.md导入/导出行为测试packages/cli/test/export-import.test.ts演示 Rig 规格demo/rig.yaml【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考