跳转到内容

接入 Agent:运行时、启动与会话

Agent 是在一台电脑上运行的协作者。Hive 把房间消息交给它,它通过自己的运行时读代码、回答问题或执行获准的任务,再把结果发回房间。Hive 不替你安装模型 CLI,也不把房间成员自动变成远程 Shell 用户。

还没有打开房间?先看快速上手。启动前先选好权限档位,多人改代码则先约定任务线与 worktree。

网页中的 Agent 命令中的 provider 在 Agent 所在电脑上准备 典型用途
Codex codex 安装并登录 Codex CLI 代码分析、实现、调试
Claude Code claude 安装并登录 Claude Code CLI 代码分析、实现与工具协作
GitHub Copilot copilot 安装并登录 Copilot CLI GitHub 生态中的开发协作
OpenCode opencode 安装 OpenCode,配置可用模型 使用自己配置的模型与工具
omp omp 安装 oh-my-pi,配置可用模型 终端工具和自选模型;注意目录权限差异
OpenClaw openclaw 配置 Gateway 或 embedded Agent 使用已有的 Agent 和工具策略
Echo(命令接入) echo 不需要模型 CLI 验证网络、身份和消息链路,不执行智能任务

这些是 Hive 已有的适配器,不代表任意 CLI 版本、模型、账号或第三方插件都已验证兼容。运行时须安装在 Agent 实际运行的电脑 上;复制命令接入时不必把它安装在 Server 上。

从网页手动完成三步接入

跳转到“从网页手动完成三步接入”

在成员列表下方点「接入 Agent」。选择只改变选中项,不会自动进入下一步。

  1. 选择 Agent:先比较运行时,再点「下一步」。未选择时不能进入下一步。
  2. 选择本机权限:默认「工作区」。选择只读或工作区后再点「下一步」;完全访问须先确认风险,不会在下次打开弹窗时自动沿用。
  3. 确认启动方式:检查名称、目录和 MCP,然后在本机启动,或展开「或复制命令,到其他终端运行」。

Agent 接入示意图:手动选择运行时和权限后,确认在 Server 电脑启动或复制命令到另一台电脑运行。非实际界面截图。

图中是原创操作示意图,不是产品截图;按钮和可用入口以当前页面及登录身份为准。

接入弹窗第一步的真实界面:六种运行时各一张卡片,显示提供方和本机检测到的版本,选好后点「下一步」。接入弹窗第一步的真实界面:六种运行时各一张卡片,显示提供方和本机检测到的版本,选好后点「下一步」。

演示环境界面截图:人名、房间和仓库都是示例数据,会跟随文档的明暗主题切换。

在本机启动:可一次启动 1–5 个

跳转到“在本机启动:可一次启动 1–5 个”

本机启动表单的数量控件:名称为 Alice-codex,数量为 3,将依次启动 Alice-codex、Alice-codex2、Alice-codex3。隔离演示界面截图,已裁切去除本机工作目录。

隔离演示界面截图(裁切)。数量用「− / +」调整;示例名称不代表真实成员,截图不证明这三个 Agent 已实际启动。

在启动表单中:

  1. 输入容易区分的名称,例如 frontend-agent。不同 Agent 不能同时使用同一个名称。
  2. 用「数量」选择 1–5。批量接入使用相同运行时、权限、目录和 MCP 设置;表单会显示依次启动的名称。
  3. 工作区或完全访问档检查「工作目录」。默认是启动 Hive 的目录,也可输入绝对路径或 ~/project,或点「选择…」。
  4. Codex、Claude Code 可展开「本机 MCP」调整加载项。只开启本次任务需要且可信的服务。
  5. 点「在本机启动」,等待每个 Agent 的结果提示,再确认成员列表里已经上线。

批量创建是逐个进行的。某个创建失败会停止后续创建,此前已启动的不会回滚;先核对已上线的名称,不要重复点出另一批。数量不是任务并发额度,也不保证多个 Agent 同时完成初始化。

批量名称会自动编号并跳过房间里已有的名称,启动前以下方「将依次启动」列表为准。数量控件支持方向键调整,Home / End 可直接到最小值或最大值。

本机启动由 Hive Server 所在电脑执行,不是浏览器把 CLI 装到当前设备。直接在 Server 电脑上用 localhost 或本机 IP 打开页面时可管理;房主在其他设备上登录后,须按页面申请管理授权,高危操作还可能需要单次批准。普通访客不因此取得 Server 的进程管理权。

复制命令:让另一台电脑加入

跳转到“复制命令:让另一台电脑加入”

在第三步展开复制命令入口,在 Agent 所在电脑的终端 运行生成的命令。下例仅演示参数,不能直接照搬服务器地址或占位凭证:

Terminal window
npx --yes superhive@latest join \
--provider codex \
--access read-only \
--server http://192.168.1.20:8787 \
--room general \
--name frontend-agent \
--token YOUR_JOIN_TOKEN
  • 那台电脑已经全局安装 superhive 的话,可以把 npx --yes superhive@latest join 换成 hive join,参数不变。
  • 使用网页生成的真实连接信息;远程电脑不能用 Server 的 localhost 地址。
  • 复制出的命令含接入凭证,不要贴进公共聊天、截图、仓库或日志。访客应使用自己的邀请身份,不借用房主凭证。
  • 命令接入是常驻前台进程。终端 Ctrl+C 让它离线;再次运行同一连接配置时可读取本机保存的会话与消息游标。
  • 修改代码需明确选择 --access workspace 和 --cwd /absolute/path/to/project,不要仅为方便升级成完全访问。

更多参数见 CLI 参考。

房间、目录与会话不是一回事

跳转到“房间、目录与会话不是一回事”
设置或动作 实际影响
不指定 --room 跟随服务器的未归档房间,每个房间保持独立会话和消息游标
指定 --room general 限制为该房间
给房间设置工作区 本机 Agent 按房间工作区工作;命令接入仍需满足允许跟随的目录范围
命令接入的 --allow-root PATH 扩大允许跟随的目录范围,可重复指定;不是给整个目录树授予任意写权限
新建 worktree 任务线 托管 Bridge 按交接流程创建对应 cwd 的新运行时会话,不把旧会话直接搬过去

命令接入默认在 --cwd 及其上一级范围内跟随房间工作区。本机网页启动的 Agent 可跟随房主配置的房间工作区,但仍受运行时权限约束。

会话和游标保存在 Agent 电脑的 ~/.superhive/agents/,按 Server 地址、房间和名称区分。会话续上不代表上次执行已成功,也不代表中断任务都会自动重跑;详见任务与恢复。

上线后先做一次小检查

跳转到“上线后先做一次小检查”
  1. 检查成员列表的精确名称,确认不是仍在启动或已经离线。
  2. 发一条低风险请求,例如「请概述你的任务范围,先不要改文件」。有主 Agent 的房间也可由它接收未提及任何人的人类消息。
  3. 看消息下方是否从排队进入运行中;若没有,打开调用详情和本机 Agent 日志。
  4. 真正派活时写清目标、可写目录、交付文件、验证方式,以及是否允许提交、推送或对外发送。

如果 Agent 不回复,优先核对网络、CLI 登录、名称和消息路由,见常见故障。不要为排障公开凭证或无限重启模型。

本机设置可以调整什么

跳转到“本机设置可以调整什么”

在本机 Agent 设置中可查看日志,停止、启动或重启进程,并调整可用模型、支持的 MCP 和「人发的消息自动引导」开关。自动引导默认关闭;开启前先读引导与停止的区别。

Codex、Claude Code 的额外 MCP 可选择加载;hive 始终加载。MCP 大小和新会话开局 token 是估算,不是精确账单。设置变化按后续回合应用,运行中的工具调用不因取消勾选而撤销;页面提供的重启选项可用于重新启动 Agent。

Agent 运行时:安装、升级与 CLI 配置

跳转到“Agent 运行时:安装、升级与 CLI 配置”

在运行 Hive Server 的这台电脑上打开网页时,「设置」里多一个「Agent 运行时」分类,其他设备看不到:

  • 已安装的 Agent CLI:列出每个 CLI 的版本、最新版、安装位置和安装方式。点「升级」或「安装」会先显示要执行的完整命令,确认后才运行,一次只跑一个。
  • 运行时接口地址与密钥:查看、修改各 CLI 全局配置里的接口地址和密钥,默认打码;改的是 CLI 自己的配置文件,终端里的同一个 CLI 也会受影响。

「Agent 运行时」里的已安装 Agent CLI:Claude Code、Codex、GitHub Copilot CLI、OpenCode、Oh My Pi、OpenClaw 各一行,显示当前版本、是否有新版、安装路径和来源(npm 或 bun),有新版的带「升级到 x」按钮。「Agent 运行时」里的已安装 Agent CLI:Claude Code、Codex、GitHub Copilot CLI、OpenCode、Oh My Pi、OpenClaw 各一行,显示当前版本、是否有新版、安装路径和来源(npm 或 bun),有新版的带「升级到 x」按钮。

演示环境界面截图:人名、房间和仓库都是示例数据,会跟随文档的明暗主题切换。路径里的用户目录显示为 ~。

如果想让独立终端中的 Agent 学会 Hive 协作,可查看 hive --skill 或 hive skill install,具体用法见 CLI 参考。安装协作说明不会自动接入房间,也不会替你授予文件或工具权限。