先決條件
設定指南
建立 Slack 應用程式
- 前往 Slack API 並點擊 Create New App
- 選擇 From scratch
- 輸入應用程式名稱(例如「AI Assistant」)並選擇您的工作區
- 點擊 Create App
啟用 Socket Mode
- 在左側邊欄中,前往 Socket Mode
- 將 Enable Socket Mode 切換為 ON
- 為 token 命名(例如「claw-socket」)並點擊 Generate
- 複製 App-Level Token(以
xapp-開頭)— 您將需要此資訊
配置 Bot 權限
- 前往邊欄中的 OAuth & Permissions
- 在 Bot Token Scopes 下,新增以下權限範圍 (scopes):
chat:write— 傳送訊息im:history— 讀取私訊 (DM) 歷史記錄im:read— 查看私訊 (DMs)im:write— 發起私訊 (DMs)app_mentions:read— 偵測 @提及 (@mentions)
- 點擊頂部的 Install to Workspace
- 授權應用程式
- 複製 Bot User OAuth Token(以
xoxb-開頭)
啟用事件
- 前往邊欄中的 Event Subscriptions
- 將 Enable Events 切換為 ON
- 在 Subscribe to bot events 下,新增:
message.im— 私訊 (DMs) 中的訊息app_mention— 頻道中的 @提及 (@mentions)
- 點擊 Save Changes
在 LemonData 控制面板中配置
- 前往您的 Claw Dashboard
- 點擊您實例上的設定圖示
- 開啟 IM Integrations 分頁
- 展開 Slack 區塊
- 貼上您的 App Token (
xapp-...) 和 Bot Token (xoxb-...) - 點擊 Save
存取控制
群組設定
在 Dashboard 的 IM Integrations 分頁中配置頻道存取權限:| 設定 | 選項 | 說明 |
|---|---|---|
| 群組策略 | Open (預設) / Allowlist / Disabled | 控制機器人在哪些頻道中回應 |
| 需要 @提及 | 開啟 / 關閉 | 機器人僅在被 @提及時回應 |
| 群組 ID | 頻道 ID 列表 | 限制於特定頻道(留空 = 所有頻道) |
| 群組允許使用者 | 使用者 ID 列表 | 僅這些使用者可以觸發機器人(白名單模式) |
疑難排解
機器人沒有回應私訊 (DMs)
機器人沒有回應私訊 (DMs)
- 驗證兩個 token 是否正確(App Token 以
xapp-開頭,Bot Token 以xoxb-開頭) - 檢查是否已訂閱
message.im事件 - 確保應用程式已安裝到您的工作區
機器人沒有回應 @提及 (@mentions)
機器人沒有回應 @提及 (@mentions)
- 檢查是否已配置
app_mentions:read權限範圍和app_mention事件 - 機器人必須先被邀請加入頻道(輸入
/invite @botname)
'not_allowed_token_type' 錯誤
'not_allowed_token_type' 錯誤
- 確保您在 App Token 欄位中使用的是 App-Level Token (
xapp-),而非 Bot Token - Bot Token (
xoxb-) 應填入 Bot Token 欄位