Buzz 接入——AI 语音聊天应用 | Easy Understand Hermes Agent

这篇教程带你用 Hermes Agent 接入 Buzz——一个基于 Nostr 协议的社区协作平台，让 AI 在频道或私聊里陪你聊天、干活。

准备工作：三样东西

Buzz 命令行工具：相当于一个“翻译官”，让 Hermes 能跟 Buzz 社区说话。从 Buzz 官方仓库编译安装，装好后确保终端能直接敲 buzz 命令。
社区地址：形如 https://mycommunity.communities.buzz.xyz 的链接，就像你家的门牌号。
Nostr 私钥：相当于你的社区门禁卡，必须是该社区已认证的成员。

第1步：填写配置文件

打开 Hermes 的 config.yaml，在 gateway 部分加入：

gateway:
  platforms:
    buzz:
      enabled: true
      extra:
        relay_url: https://mycommunity.communities.buzz.xyz
        channels: []          # 留空=监听所有已加入的频道
        home_channel: ""      # 定时任务/通知的默认发送频道
        poll_interval: 4      # 每4秒检查一次新消息
        allowed_users: []     # 留空=默认只允许自己用
        require_mention: true # 频道里必须@才回应

第2步：保存私钥（重要！）

私钥是敏感信息，永远不要写进 config.yaml。单独放在 ~/.hermes/.env 文件里：

BUZZ_PRIVATE_KEY=nsec1...

第3步：推荐设置（保持频道干净）

在 config.yaml 里加上这两段，避免 AI 把“思考过程”刷屏到频道：

display:
  platforms:
    buzz:
      interim_assistant_messages: false  # 只发最终结果
      tool_progress: off                 # 不显示工具执行进度

这样频道里只有 AI 的最终回答，没有中间步骤——就像你只看到厨师端上来的菜，而不是后厨的锅碗瓢盆。

第4步：启动网关

hermes gateway start

查看状态用 hermes gateway status。

怎么跟 AI 说话？

频道里：必须 @AI 的名字或 npub 地址，它才会回应。其他消息一律忽略。
私聊：直接发消息就行，不用 @。
访问控制：默认只有你列出的用户能用。想开放给全社区，把 allow_all_users 设为 true。

几个小提醒

消息有延迟：默认每4秒轮询一次，所以 AI 回复可能最多晚4秒。
历史不重播：AI 重连后不会把旧消息翻出来重新处理。
私钥安全：它只通过环境变量传给命令行工具，不会出现在日志里。

总结：接入 Buzz 只需四步——装工具、填配置、存私钥、启动网关。默认设置下 AI 只在被 @ 时回应，频道干净不刷屏。

下篇预告：下一期我们聊聊如何让 AI 主动汇报——用定时任务把每日摘要推送到 Buzz 频道，敬请期待！