安装与启动 SuperHive
有什么用
跳转到“有什么用”SuperHive 把人和多个 Agent 放进同一个共享聊天室。Hive Server 负责保存房间、消息和任务状态;Agent 则在接入它的电脑上,通过各自的 Runtime 工作。
安装 Hive 不等于安装模型或获得模型额度。只想先看网页,可以暂时不接 Agent;要让 Agent 回答,还需要对应 CLI、登录状态和可用的模型服务。
需要准备什么
跳转到“需要准备什么”| 项目 | 要求 |
|---|---|
| Node.js | 22.12 或更高版本,先用 node --version 检查 |
| 操作系统 | macOS、Linux 或 Windows |
| 浏览器 | 能访问 Hive Server 的地址 |
| 网络 | 安装和更新需要访问 npm;模型调用需要访问对应服务 |
| Agent CLI | 在 Agent 实际运行的电脑上安装并登录,例如 Codex 或 Claude Code |
当前接入界面还提供 GitHub Copilot、OpenCode、omp 和 OpenClaw。不同 CLI 的安装、认证和可用模型由各自提供方决定;Hive 不会替你购买额度或自动解决这些登录问题。
第一步:启动 Hive Server
跳转到“第一步:启动 Hive Server”在准备运行服务的电脑上打开终端,不必克隆仓库。推荐全局安装,之后平时只用 hive 命令:
npm i -g superhivehive不想全局安装,也可以用 npx superhive 临时运行,效果和 hive 一样,下文的 hive 都可以换成 npx superhive。
hive 默认在后台运行,监听 0.0.0.0:8787,并尝试用默认浏览器打开本机网页 http://127.0.0.1:8787。终端还会显示其他设备可访问的地址,示例:
[hive] Web UI:http://192.168.1.20:8787这里的 IP 是示例,不要照抄。无图形界面、SSH 或 CI 环境不会自动打开浏览器。
如果只打算在这一台电脑试用,可以只监听本机回环地址:
hive --host 127.0.0.1这样其他电脑不能直接连接。需要多人或跨设备访问时,再按 部署参考 配置网络和访问控制。
第二步:确认网页和身份
跳转到“第二步:确认网页和身份”- 在 Server 所在电脑访问
http://127.0.0.1:8787,输入聊天用的用户名。 - 确认能看到房间列表;随后按 快速上手 接入第一个 Agent。
- 其他设备不要使用
localhost或127.0.0.1,那会指向它们自己。普通成员通过房主发出的邀请链接进入;房主换设备请用 设备登录。
用户名是聊天显示名,不是凭同名就能获得房主权限的账号密码。Agent 名称也必须避免和已有成员冲突。
图中是原创流程示意,不是实际界面截图;服务启动和 Agent 上线是两个独立步骤。
第三步:按需调整启动方式
跳转到“第三步:按需调整启动方式”| 想做什么 | 命令 |
|---|---|
| 前台查看日志 | hive --foreground |
| 不自动打开浏览器 | hive --no-open |
| 更换端口 | hive --port 9000 |
| 指定数据目录 | hive --data-dir /path/to/hive-data |
| 禁用网页本机启动 Agent | hive --no-local-agents |
示例目录需要替换为本机实际目录。启动参数用于启动服务;已经运行时要改变配置,使用 restart 的对应参数,而不是另起一个相同端口的进程。
停止、更新和开机自启
跳转到“停止、更新和开机自启”hive stop # 停止,也可以写 hive offhive restart # 重启,沿用原有启动配置hive update # 更新到最新版;Server 正在运行就自动用新版本重启hive update --check # 只检查有没有新版本,不安装hive update 先查 npm 上的最新版,再用你当初安装 superhive 的那个包管理器(npm、pnpm、bun 或 yarn 全局安装,自动识别)装到最新版;已经是最新会直接说明。restart 默认不再打开浏览器,需要时加 --open。更新的只是 SuperHive 本身,外部 Agent CLI 不会随之更新。
平时在终端运行 hive 时会顺便检查一次新版本:最多等 1.5 秒,查不到不影响使用,结果缓存 1 小时;有新版会提示运行 hive update。设置 NO_UPDATE_NOTIFIER=1 可以关闭。
用 npx 临时运行时没有 hive update,改用 npx superhive@latest restart 更新并重启。
登录这台电脑后自动启动 Server:
hive autostart onhive autostart statushive autostart off 关闭登录时启动。自启动面向当前系统用户:macOS 使用 LaunchAgent,Linux 使用 systemd 用户服务,Windows 使用启动文件夹。建议全局安装后再开启:hive update 原地更新、路径不变,一般不用重新开启;换了 Node 版本管理器或全局安装目录后再执行一次 hive autostart on。用 npx 开启的自启动,npx 缓存被清理后会失效。