跳轉到主要內容
使用 Socket Mode 為您的 Slack 工作區添加 AI 助手 — 無需公開 URL。本指南適用於託管的 Claw 實例和自託管的 LemonClaw 部署。

​
先決條件

​
設定指南

1

建立 Slack App

  1. 前往 Slack API 並點擊 Create New App
  2. 選擇 From scratch
  3. 輸入應用程式名稱（例如 “AI Assistant”）並選擇您的工作區
  4. 點擊 Create App
2

啟用 Socket Mode

  1. 在左側側邊欄中，前往 Socket Mode
  2. 將 Enable Socket Mode 切換為 ON
  3. 為 token 命名（例如 “claw-socket”）並點擊 Generate
  4. 複製 App-Level Token（以 xapp- 開頭）— 您將需要此資訊
3

配置 Bot 權限

  1. 前往側邊欄中的 OAuth & Permissions
  2. 在 Bot Token Scopes 下，添加以下權限範圍 (scopes)：
    • chat:write — 發送訊息
    • im:history — 讀取私訊 (DM) 歷史記錄
    • im:read — 查看私訊 (DMs)
    • im:write — 發起私訊 (DMs)
    • app_mentions:read — 偵測 @提及 (@mentions)
  3. 點擊頂部的 Install to Workspace
  4. 授權應用程式
  5. 複製 Bot User OAuth Token（以 xoxb- 開頭）
4

啟用事件 (Events)

  1. 前往側邊欄中的 Event Subscriptions
  2. 將 Enable Events 切換為 ON
  3. 在 Subscribe to bot events 下，添加：
    • message.im — 私訊 (DMs) 中的訊息
    • app_mention — 頻道中的 @提及 (@mentions)
  4. 點擊 Save Changes
5

開啟 LemonClaw WebUI

  1. 如果您使用的是託管版 Claw，請前往您的 Claw Dashboard 並點擊 Open WebUI
  2. 如果您是自託管 LemonClaw，請開啟您自己的 WebUI（例如 http://your-ip:18789）並使用您的 token 登入
  3. 在 WebUI 中，導覽至 Settings → Channels
  4. 展開 Slack 區塊
  5. 貼上您的 App Token (xapp-...) 和 Bot Token (xoxb-...)
  6. 點擊 Save
6

開始聊天

  1. 在 Slack 中，向您的 bot 發送私訊 (DM) 或在頻道中 @提及它
  2. 第一位使用者將自動配對為所有者 — 無需程式碼！
  3. 開始與 AI 聊天！

​
存取控制

​
群組設定

在 LemonClaw WebUI 的 Channels 設定中配置頻道存取權限：
設定選項描述
Group PolicyOpen (預設) / Allowlist / Disabled控制 bot 在哪些頻道中回應
Require @mention開啟 / 關閉Bot 僅在被 @提及時回應
Group IDs頻道 ID 列表限制於特定頻道（留空 = 所有頻道）
Group Allowed Users使用者 ID 列表僅這些使用者可以觸發 bot（白名單模式）
預設情況下，Slack 使用 open 群組策略 — bot 會在所有受邀進入的頻道中回應。使用 allowlist 可限制於特定頻道。

​
故障排除

  • 驗證兩個 token 是否正確（App Token 以 xapp- 開頭，Bot Token 以 xoxb- 開頭）
  • 檢查是否已訂閱 message.im 事件
  • 確保應用程式已安裝到您的工作區
  • 檢查是否已配置 app_mentions:read 權限範圍和 app_mention 事件
  • 必須先將 bot 邀請至頻道（輸入 /invite @botname）
  • 確保您在 App Token 欄位中使用的是 App-Level Token (xapp-)，而非 Bot Token
  • Bot Token (xoxb-) 應填入 Bot Token 欄位