LightVela

Slack

通过 Slack Bot Token 和 App Token 将 Hermes Agent 接入 Slack。

配置通道 - Slack

Slack 通道采用 Bot Token 和 App Token 接入方式，适合将 Hermes Agent 接入团队频道、私信和自动任务通知场景。

本页覆盖

  • 创建 Slack App，并配置 Socket Mode、权限和事件

  • 在 LightVela 中绑定 Slack Bot Token 和 App Token

  • 在 Slack 频道和私信中与 Hermes Agent 对话

操作步骤

1. 打开 LightVela 的 Slack 通道入口

登录 LightVela 国际站，进入 My Hermes → Channel，找到 Slack 卡片并点击 + Connect。稍后需要填写两个 Token：

  • Slack Bot Token：以 xoxb- 开头。
  • Slack App Token：以 xapp- 开头。

2. 创建 Slack App

  1. 打开 Slack API Apps 并登录。
  2. 点击 Create New App。

在 Slack API Apps 页面创建新 App

  1. 选择 From scratch。

选择 From scratch 创建 Slack App

  1. 输入 App 名称，例如 Hermes Agent。
  2. 选择 Hermes Agent 要接入的 workspace，然后点击 Create App。

填写 Slack App 名称并选择 workspace

如果列表中没有目标 workspace，请确认当前 Slack 账号已加入该 workspace，并拥有创建 App 的权限。

3. 创建 App Token

App Token 用于通过 Socket Mode 建立 WebSocket 连接，必须包含 connections:write scope。

  1. 在 Slack App 左侧进入 Settings → Basic Information。

打开 Slack App 的 Basic Information

  1. 向下找到 App-Level Tokens，点击 Generate Token and Scopes。

在 App-Level Tokens 中生成 Token

  1. 输入便于识别的 Token 名称，例如 HermesSocket。
  2. 点击 Add Scope。

为 App Token 添加 scope

  1. 搜索并选择 connections:write。

选择 connections write scope

  1. 确认 scope 已添加，点击 Generate。

生成带 connections write 的 App Token

  1. 复制生成的 xapp-... Token，并保存在安全位置。复制后点击 Done。

复制 Slack App Token

不要把 App Token 填到 Bot Token 字段，也不要使用 Client Secret 或 Signing Secret 代替它。

4. 配置 Socket Mode、权限和事件

4.1 开启 Socket Mode

  1. 在左侧进入 Settings → Socket Mode。
  2. 打开 Enable Socket Mode。

开启 Slack Socket Mode

Socket Mode 通过 WebSocket 向 Hermes Agent 发送 Slack 事件。使用此接入方式时，不需要配置 Event Subscriptions 的 Request URL，也不需要配置 OAuth Redirect URL。

4.2 添加 Bot Token Scopes

  1. 进入 Features → OAuth & Permissions。
  2. 向下找到 Scopes → Bot Token Scopes。
  3. 点击 Add an OAuth Scope。

在 OAuth Permissions 中添加 Bot scope

按使用场景添加以下权限：

Scope是否必需用途
app_mentions:read频道场景必需接收频道中 @ Bot 的消息
channels:read公开频道必需读取公开频道基本信息
channels:history公开频道必需读取 Bot 已加入的公开频道消息
chat:write必需以 Bot 身份发送回复
im:read私信场景必需读取私信会话信息
im:history私信场景必需读取发送给 Bot 的私信
im:write私信场景必需创建或管理私信会话
groups:read私有频道可选读取私有频道基本信息
groups:history私有频道可选读取 Bot 已加入的私有频道消息

核对 Slack Bot Token Scopes

仅在需要使用私有频道时添加两个 groups:* scopes。Bot 仍需被邀请进入目标频道后才能接收频道消息。

4.3 开启 App Home 私信入口

如果用户需要直接给 Hermes Agent 发私信：

  1. 进入 Features → App Home。
  2. 向下找到 Show Tabs。
  3. 打开 Messages Tab。
  4. 打开允许用户从 Messages Tab 发送消息的选项。

如果只计划在频道中 @ Bot，可以跳过这一小节，也不需要 im:* scopes 和 message.im 事件。

4.4 订阅 Bot 事件

  1. 进入 Features → Event Subscriptions。
  2. 打开 Enable Events。
  3. 在 Subscribe to bot events 下点击 Add Bot User Event。
  4. 添加 app_mention，用于接收频道中的 @ 提及。
  5. 如果需要私信，再添加 message.im。
  6. 点击 Save Changes。

配置 Slack Bot 事件订阅

安装 App 后如果修改了 scopes 或事件，请回到 OAuth & Permissions，点击 Reinstall to Workspace。重新安装后，新权限才会生效。

5. 安装 App 并复制 Bot Token

  1. 回到 Features → OAuth & Permissions。
  2. 点击 Install to Workspace。如果 App 已安装，点击 Reinstall to Workspace。

将 Slack App 安装到 workspace

  1. 检查请求的权限，点击 Allow。

授权 Slack App 请求的权限

  1. Slack 返回 OAuth & Permissions 后，找到 OAuth Tokens for Your Workspace。
  2. 复制以 xoxb- 开头的 Bot User OAuth Token。

复制 Slack Bot User OAuth Token

不要使用 Signing Secret、Client Secret、Verification Token 或以 xoxp- 开头的 User OAuth Token。LightVela 只需要一个 xapp-... App Token 和一个 xoxb-... Bot Token。

6. 在 LightVela 绑定 Slack

  1. 返回 My Hermes → Channel → Slack。
  2. 将 xoxb-... 填入 Slack Bot Token。
  3. 将 xapp-... 填入 Slack App Token。
  4. 确认两个 Token 未填反，然后提交连接。
  5. 等待 Slack 卡片显示为已接入。

7. 在 Slack 中测试 Hermes Agent

7.1 测试频道提及

  1. 打开要使用 Hermes Agent 的 Slack 频道。
  2. 邀请 App 加入频道：
/invite @Hermes Agent
  1. 发送一条带 @ 提及的消息：
@Hermes Agent 请总结这个频道今天讨论的重点。

Bot 只有在加入频道后，才能接收该频道中的消息。

7.2 测试私信

  1. 在 Slack 左侧 Apps 区域打开刚创建的 App。
  2. 进入 Messages 标签。
  3. 发送一条简短消息，例如 你好。

在 Slack App Home 中测试私信

成功状态

配置成功后，应同时满足：

  • LightVela 的 Slack 卡片显示为已接入。
  • Slack App 已安装到目标 workspace。
  • 在已加入的频道中 @ Bot 后，Hermes Agent 可以回复。
  • 开启 App Home 和 IM 权限后，Hermes Agent 可以回复私信。

支持的消息类型

接入成功后，Slack 通道支持以下消息场景：

Slack 通道支持的消息类型是否支持
接收频道中的 @ 提及文本✅ 已支持
接收 App Home 私信文本✅ 已支持
回复频道和私信文本✅ 已支持
主动发送消息（如自动任务通知）✅ 已支持

常见问题

问题可能原因处理方式
App Token 无效Token 类型错误，或缺少 connections:write在 Basic Information → App-Level Tokens 重新生成 xapp-... Token
Bot Token 无效使用了 User OAuth Token 或其他凭据在 OAuth & Permissions 复制 xoxb-... Bot User OAuth Token
Event Subscriptions 要求 Request URLSocket Mode 尚未开启先开启 Settings → Socket Mode，再返回事件订阅页面
收不到频道 @ 消息App 未加入频道、缺 scope 或未订阅事件邀请 App，补齐频道 scopes 和 app_mention，然后重新安装 App
收不到私信Messages Tab 未开启、缺 IM scope 或未订阅事件开启 Messages Tab，补齐 im:* 和 message.im，然后重新安装 App
新权限没有生效修改权限后没有重新安装在 OAuth & Permissions 点击 Reinstall to Workspace
已接入但没有回复模型不可用、额度不足或 Agent 状态异常检查 配置模型、实例状态与可用额度

下一步

Discord

通过 Discord 与 Hermes Agent 对话。

WeChat

通过微信与 Hermes Agent 对话。

本页目录

配置通道 - Slack本页覆盖操作步骤1. 打开 LightVela 的 Slack 通道入口2. 创建 Slack App3. 创建 App Token4. 配置 Socket Mode、权限和事件4.1 开启 Socket Mode4.2 添加 Bot Token Scopes4.3 开启 App Home 私信入口4.4 订阅 Bot 事件5. 安装 App 并复制 Bot Token6. 在 LightVela 绑定 Slack7. 在 Slack 中测试 Hermes Agent7.1 测试频道提及7.2 测试私信成功状态支持的消息类型常见问题下一步