OpenRig 身份机制全解：rig bind 与 rig whoami 如何让 Agent 自报家门

OpenRig 身份机制全解rig bind 与 rig whoami 如何让 Agent 自报家门【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig多智能体编排工具把 Claude Code 与 Codex 装进同一个团队里有两件事最容易被忽略rig bind负责把野生的 Agent 会话绑定进团队拓扑rig whoami负责让 Agent 在任意时刻自报家门。这两条命令合起来就是 OpenRig 的 Agent 身份物化底层机制——谁在哪个 Rig、哪个 Pod、哪个座位上以及它和谁有协作关系全部有账可查。为什么多 Agent 团队需要身份物化单开一个 Claude Code 或 Codex你知道自己在跟谁说话。但当 6 个 Agent 会话同时跑在 tmux 里时问题就来了这个会话属于哪个 Rig它对应拓扑里的哪个节点Seat它的同僚是谁、协作边Edge指向哪里OpenRig 的答案是把身份物化——会话不再只是一个终端窗口而是拓扑图上一个有稳定地址的节点比如dev-ownerfirst-project。这正是 Seat 概念 的核心会话可以换座位的身份保持不变。rig bind把发现的会话认领进拓扑第一步用 rig discover 找到野生会话你手动开的 Claude Code / Codex 会话并不天然属于任何 Rig。先让 OpenRig 扫描 tmuxrig discover它会给每个发现的会话打指纹分配一个discoveredId。第二步用 rig bind 绑定到目标节点绑定命令的两种模式是互斥的XOR 校验两者不能同时给也不能都不给见 bind.ts模式参数用途A挂靠已有节点--rig rigId --node logicalId把会话绑到拓扑中已存在的座位上B在 Pod 内新建节点--rig rigId --pod namespace --member name在指定 Pod 里现场创建一个新座位并绑定# 模式 A绑定到已有节点 rig bind discoveredId --rig first-project --node dev-owner # 模式 B在 dev Pod 里新建一个叫 dev-check 的座位 rig bind discoveredId --rig first-project --pod dev --member dev-check绑定在校验什么CLI 只是把请求转发给守护进程的统一绑定端点POST /api/discovery/:id/binddiscovery.ts真正的校验发生在服务端404 系Rig 不存在、节点不存在、Pod 不存在、会话不存在409 系会话已被绑定already_bound、运行时不匹配runtime_mismatch比如 Codex 会话绑到 Claude 节点、逻辑 ID 重复duplicate_logical_id这套失败即拒绝的设计保证了拓扑的唯一归属一个会话只能物化到一个座位上。rig whoamiAgent 如何自报家门身份解析的 8 级瀑布rig whoami最精妙的是身份来源的解析链whoami.ts按优先级从高到低--node-id显式指定--session显式指定OPENRIG_NODE_ID环境变量OPENRIG_SESSION_NAME环境变量tmux 元数据rigged_node_id最强锚点由 managed 启动时写入tmux 元数据rigged_session_name原始 tmux 会话名最弱回退全部失败 → 报错第 5、6 级是关键OpenRig 启动 Agent 时会向 tmux pane 注入元数据标签即使环境变量丢失座位身份仍然刻在终端上——这就是身份物化的物理层面。一次 whoami 告诉你什么rig whoami人类可读输出包括身份块Rig、Logical ID、Pod/Member、Session、RuntimePeers同 Rig 花名册不含自己可直接用于rig sendEdges出向→与入向←协作边Transcript本座位对话记录的落盘路径服务端由 WhoamiService 从 SQLite 中连表解析节点、会话、边、Pod 和绑定关系如果会话名指向多个节点返回 409 歧义错误并提示改用--node-idwhoami.ts。紧凑投影为恢复现场而设计默认的rig whoami --json并非全量输出而是走白名单投影projectCompactWhoami只保留身份、peers、edges、transcript 这四类启动 压缩恢复必需的字段。为什么因为 Agent 每次启动和上下文压缩后都会调用它来找回我是谁全量 payload 会白白吃掉宝贵的上下文窗口。要看完整数据上下文用量、运行时细节等加--full。跨主机场景团队跑在多台机器上时rig whoami支持--host id单主机查询、--all-hosts全量扇出runFanOutWhoami一次看清每台主机上各自运行了哪些 Rig。一图看懂两者的关系rig discover ──→ 发现野生会话 (discoveredId) │ rig bind ──→ 物化进拓扑座位获得稳定地址 │ rig whoami ──→ 从 tmux 元数据/环境变量反查 │ 输出Rig / Pod / Session / Peers / Edgesbind 是写入身份whoami 是读出身份一写一读构成了 OpenRig 中 Agent 自报家门的完整闭环。快速上手清单 ✅rig discover—— 扫描现有会话rig bind id --rig name --node logicalId—— 认领进拓扑rig whoami—— 验证座位身份rig whoami --full --json—— 查看完整上下文与用量rig ps --nodes—— 全量座位清单whoami 404 时的排查入口想要更大规模的例子可以浏览仓库内置的 demo/rig.yaml 和各 Agent 定义demo/agents/感受 bind/whoami 在真实多座位团队里的位置。核心源码入口packages/cli/src/commands/bind.ts · packages/cli/src/commands/whoami.ts · packages/daemon/src/routes/discovery.ts · packages/daemon/src/domain/whoami-service.ts【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考