nickvasilescu/bot-hq

项目介绍

Bot HQ 是一个实验性的 TypeScript 应用，用来管理一小队可以对话的 AI 机器人。每个机器人由一个 Hermes Agent 驱动，并在同一台 Orgo Linux 云电脑上拥有自己的屏幕。机器人可以通过 Composio 连接应用（写操作需在聊天卡片上批准），使用 xAI 实时语音和 x_search 工具，还能设定时例程、维护任务列表并把产出存进共享的 Library。

界面参考 Grok Bot：每轮结束后会折叠成可展开的「耗时与步骤」卡片，侧栏可以实时观看或接管机器人桌面。应用在 Hermes 网关的 /v1/responses 之上构建了自己的机器人层，并通过 MCP 向 agent 提供工具；它刻意不复用 Hermes Desktop 的 Bot Mode，因此两边创建的机器人互不可见。

使用前准备

需要一个已开启 API server 的 Hermes 网关、一台 Orgo 电脑（为该电脑的 8787 端口创建公网 URL），以及 Orgo、Composio、xAI 三个服务的 API Key。运行环境要求 Node.js 22 或更高版本。第一个机器人就是电脑上已有的 Hermes agent，应用只调用其网关，不会重启它或改写其配置。

快速开始：安装到 Orgo 电脑

1. 在你自己的机器上打包：npm ci && scripts/pack.sh hq-app.tgz，把 hq-app.tgz 和 scripts/install-on-computer.sh 复制到 Orgo 电脑。

2. 在 Orgo 里为该电脑的 8787 端口创建公网 URL。

3. 在电脑上以 root 身份运行安装脚本，提供公网 URL、电脑 ID、允许登录的邮箱、包含 XAI_API_KEY= 和 COMPOSIO_API_KEY= 的密钥文件（若 Hermes 的 .env 中没有 ORGO_API_KEY= 也需加入），以及主 agent 已有 Chrome 时的调试地址：

   PUBLIC_URL=https://<name>.orgo.dev ORGO_COMPUTER_ID=<uuid> ALLOWED_EMAILS=you@example.com \
   KEYS_FILE=/root/keys.txt PRIMARY_CDP_URL=http://127.0.0.1:9333 \
     bash install-on-computer.sh hq-app.tgz
   

   脚本安装到 /opt/hq，新增一个 supervisor 程序，并在首次安装后删除密钥文件。用更新的包再次运行即可升级并保留配置和数据。

4. 给主 agent 注册应用工具：python3 /opt/hq/app/scripts/add-hq-to-hermes.py（用 --remove 撤销）。

5. 打开公网 URL 用 Google 登录；若尚未配置 Google 登录，可在电脑上运行 bash /opt/hq/app/scripts/sign-in-link.sh you@example.com 生成一次性登录链接。

本地开发时，克隆仓库、执行 npm ci、按 .env.example 填写 .env，再启动服务端（npm run dev -w server，API 在 :8787）和前端（npm run dev -w web，界面在 :5173）。设置 HQ_LOCAL=0 后服务端改走 Orgo API 而不在本地电脑执行命令；DEV_LOGIN=1 启用仅邮箱登录，只能用于本地，切勿暴露在公网地址上。

使用约束

项目明确标注为实验性，未做安全审计。所有机器人共享一台电脑，因此可以访问彼此的文件。审批卡片只拦截 Composio 的写操作，浏览器和 shell 里的操作不受门控，Hermes 自身的「危险命令」提示也尚未在应用中展示。受 Orgo 每台电脑四块屏幕的限制，机器人最多四个。使用消费级模型订阅驱动 agent 需自行确认服务商条款。应用部分位置仍沿用旧名「Grokbot」。代码采用 MIT 许可，但机器人形象和部分第三方图标不在该许可覆盖范围内。

HotRepo 点评

该仓库在 2026-11-12 的新项目榜上记录到 111 stars、36 forks，在约一小时（13:15–14:15 UTC）的观测窗口内净增 9 stars。样本太短，不足以判断持续热度，也没有记录到全部语言日榜名次。技术上值得注意的是它主动与 Hermes Bot Mode 分道：每个额外机器人一个网关、例程和机器人互发消息由应用自己实现，屏幕按机器人分配并受 Orgo 四屏上限约束。README 中如实写出的限制——共享文件系统、浏览器和 shell 不受门控——才是准备接入真实应用前需要权衡的部分。