本技能用于在一台机器上运行专用 Hermes Agent,并作为原生消息代理接入另一台机器使用的 Buzz 社区。默认拓扑为 Buzz 桌面/网页客户端 → Buzz relay ← 远程 Hermes 网关,客户端不通过 SSH 连接 Hermes 主机,两者各自连接同一 relay,桌面端离线时 Hermes 仍可运行。技能强调实际执行安装配置,直到 CLI 可用、relay 授权成功、网关日志显示 buzz connected,并完成一条入站和一条出站消息验证。
适用场景:Buzz 桌面端与 Hermes 分处不同机器且需持续运行;用户创建了 Buzz 代理但网关无响应;错误依次经历 buzz CLI 缺失、relay_membership_required、零频道或提及被忽略;或将现有原生 Buzz/Hermes 网关迁移到 Linux、macOS、Windows、WSL。若用户希望 Buzz 托管运行时并显示 ACP 活动,应改用官方 buzz-acp relay-bridge 指南。
主要流程:先探测主机、架构、活动 Hermes 配置与工具,确认拓扑;获取专用 Buzz 身份(勿复用人类 nsec,秘钥仅本地隐藏输入,存入活动 profile 的 Hermes secret 环境文件);安装可移植的 buzz CLI(优先使用经验证的预编译版本,必要时从固定稳定标签构建,如 git clone --depth 1 --branch <stable-tag> https://github.com/block/buzz.git <build-dir> 与 cargo build --release -p buzz-cli);用 hermes config set 配置非密钥项,默认 allow_all_users: false、显式 owner 白名单、require_mention: true;验证身份与 relay 准入;必要时通过 NIP-OA 证明;按操作系统安装并启动网关(Linux/macOS 可用 hermes gateway install --force 与 hermes gateway start,Windows 原生用 hermes gateway run,持久化需经用户批准);最后做端到端验证。
限制与安全:不得在聊天中索要 nsec、API token 或 owner key,不得打印或记录私钥;非密钥设置只用 hermes config set,不手改 config.yaml;安装 Rust、Git、构建工具或修改持久化配置前须获批准;不要将频道成员资格等同于 relay 成员资格;失败按阶梯逐层排查。具体价格或收费信息暂未提供。