SuperAPI AI 工具集

buzz-hermes-gateway

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:把 Hermes Agent 网关接入 Block Buzz 社区,使其成为该社区中的原生消息成员,在指定频道中接收与回复消息。资料未提供该技能的独立安装方式,仅说明其使用场景与配置要点。

主要能力与架构:Buzz Desktop 通过 wss://、buzz CLI 通过 https:// 连接反向代理(TLS + WebSockets),再转发到 relay :3000 及 Postgres/Redis/MinIO。CLI 与网关使用 https://<buzz-fqdn>,Desktop 使用 wss://<buzz-fqdn>。

身份隔离:操作者(人类)密钥仅留在 Desktop;代理使用专用密钥 BUZZ_PRIVATE_KEY。allowlist 中填操作者的公开 hex/npub(允许谁对话),代理本身需加入各频道并作为该公钥发帖,可用 buzz users get 校验显示的是代理而非人类。

前置条件:relay 健康(curl -fsS https://<buzz-fqdn>/_liveness)、Hermes 安装含 plugins/platforms/buzz/、网关主机 PATH 中有 buzz CLI、专用代理密钥对并已在 relay 上 add-member、代理已加入每个监听频道。若镜像缺少 CLI,可从 github.com/block/buzz 完整克隆后构建:cargo build --release --locked -p buzz-cli,再 install -m 755 target/release/buzz /usr/local/bin/buzz。

配置:在 ~/.hermes/config.yaml 的 gateway.platforms.buzz 下设置 enabled、relay_url、cli_path、channels、home_channel、poll_interval、require_mention、allow_all_users、allowed_users;在 ~/.hermes/.env 设置 BUZZ_RELAY_URL、BUZZ_PRIVATE_KEY、BUZZ_CLI_PATH、BUZZ_HOME_CHANNEL、BUZZ_CHANNELS、BUZZ_ALLOW_ALL_USERS、BUZZ_ALLOWED_USERS。需通过 systemd 的 EnvironmentFile 将 .env 加载进网关进程,并执行 systemctl --user daemon-reload 与 hermes gateway restart(裸 reload 常不重读 .env)。重启应从宿主 shell/SSH/独立 TUI 发起。

验证与排错:在 ~/.hermes/logs/gateway.log 中查找连接记录;如出现 Unauthorized user,需补上被拒的 hex、确保 EnvironmentFile 生效并回收进程。状态 UI 可能不显示插件平台,可查看 ~/.hermes/gateway_state.json。常见问题包括复用人类密钥、只填 npub 无 hex、.env 未被 systemd 加载、reload 未回收进程、从代理工具自重启、https/wss 混淆、代理未加入频道、relay 前的 Edge SSO。

安全默认:专用代理密钥、密钥权限 600、仅操作者 allowlist、多用户房间要求 @提及、切勿粘贴 nsec。资料未提供移动配对与代理头像以外内容,移动配对不属于本网关任务,需在 relay 主机部署 buzz-pair-relay;代理头像可用 buzz upload file 与 buzz users set-profile 设置。