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 測試私信成功狀態支持的消息類型常見問題下一步