🤖HermesBlog
EN
Hermes 消息平台接入 · 第4篇2026/8/9· Easy Understand Hermes Agent

Slack 接入——团队办公的 AI 搭档

Hermes 消息平台接入第4篇：Slack。在团队频道里直接指挥 Hermes。

这篇教程将手把手教你如何把 Hermes Agent 接入 Slack，让 AI 助手成为你团队里的“数字同事”。

准备工作：理解几个“黑话”

Slack 接入的核心是把 AI 变成一个机器人（Bot）。想象一下，你正在给这位“新同事”办入职手续：需要给它一个工牌（Token）、告诉它办公室规则（权限）、并开通它进入各个会议室（频道）的门禁。

两个关键“工牌”：

  • xoxb- 开头的 Bot Token：相当于 AI 的“员工工牌”，证明它是谁。
  • xapp- 开头的 App Token：相当于“门禁卡”，让它能通过安全通道（Socket Mode）连上公司网络。

好消息：Hermes 用的是现代 Socket Mode 连接方式，不需要公网 IP，在公司防火墙后面、甚至你家里的电脑上都能运行。

第 1 步：创建 Slack 应用（选 A 或 B）

方式 A（推荐）：让 Hermes 帮你自动生成配置

打开终端，运行一行命令，Hermes 会生成一份“入职登记表”（Manifest），自动填好所有权限和命令：

hermes slack manifest --agent-view --write

然后访问 api.slack.com/apps，点击 Create New App → From an app manifest，粘贴生成的内容，一路点击“下一步”即可。

方式 B：手动创建——如果你喜欢自己动手，选择 From scratch，按提示填写名称和工作区即可。

第 2 步：配置权限（给 AI 发“工作许可证”）

在左侧菜单进入 OAuth & Permissions，添加以下关键权限：

权限 作用
chat:write 让 AI 能发消息
channels:history 让 AI 能读公开频道消息
groups:history 让 AI 能读私密频道消息
files:read 让 AI 能读取你上传的图片/音频

⚠️ 重点：忘记加 channels:history 和 groups:history，AI 在频道里就是个“睁眼瞎”，只能在私聊里工作。

第 3 步：开启 Socket Mode（开通“安全通道”）

进入 Settings → Socket Mode，打开开关，创建一个 App-Level Token（名字随意），记得勾选 connections:write 权限。生成的 xapp- 开头令牌就是你的 SLACK_APP_TOKEN。

第 4 步：订阅事件（告诉 Slack 什么消息要转给 AI）

进入 Features → Event Subscriptions，开启事件订阅，添加以下事件：

  • message.im（私聊消息）
  • message.channels（公开频道消息）
  • message.groups（私密频道消息）
  • app_mention（@AI 时触发）

🚨 这是最常见的坑：如果 AI 在私聊正常、在频道里没反应，99% 是漏加了 message.channels 或 message.groups。

第 5 步：开启消息标签页（让用户能私聊 AI）

进入 App Home，找到 Show Tabs，打开 Messages Tab 开关，并勾选允许用户发送消息。没有这一步，私聊功能会完全被屏蔽。

第 6 步：安装应用到工作区

进入 Settings → Install App，点击 Install to Workspace，同意权限后，你会得到一个 xoxb- 开头的 Bot User OAuth Token，这就是你的 SLACK_BOT_TOKEN。

小提示：以后修改了权限，记得回来重新安装一次，否则改动不生效。

第 7 步：找到你的用户 ID（用于白名单）

点击 Slack 左下角你的头像 → View full profile → 点 ⋮ → Copy member ID。得到的 U 开头字符串就是你的 ID。

第 8 步：配置 Hermes 并启动

编辑 ~/.hermes/.env 文件：

SLACK_BOT_TOKEN=xoxb-你的令牌
SLACK_APP_TOKEN=xapp-你的令牌
SLACK_ALLOWED_USERS=U01ABC2DEF3   # 多个 ID 用逗号分隔

然后启动：

hermes gateway          # 前台运行
hermes gateway install  # 后台服务运行

第 9 步：把 AI 拉进频道

启动后，在 Slack 频道里输入 /invite @你的机器人名字，它就能开始工作了！

总结

接入过程就像给 AI 办“入职手续”：创建应用 → 授权 → 开通通道 → 订阅事件 → 安装 → 配置 → 邀请入群。最关键的三个坑：频道事件订阅、消息标签页、以及权限重新安装。

下篇预告：接入完成后，如何让 AI 在 Slack 里真正“干活”？下一篇将介绍常用斜杠命令（/btw、/stop）和定时消息的玩法，敬请期待！

📖 官方文档

本文根据 Hermes Agent 官方文档编写，原文见：官方文档 › user-guide/messaging/slack

← 返回全部文章