Slack 機器人設定

逐步教學：將 Claw Buff Agent 連接到 Slack

將您的 Claw Buff AI Agent 連接到 Slack 工作區。機器人將回應私訊、提及和 /claw 斜線指令。設定大約需要 10 分鐘。

前置需求

一個您擁有管理員權限（或可安裝應用程式權限）的 Slack 工作區
已部署的 Claw Buff Agent（快速入門）

步驟 1：建立 Slack 應用程式

開啟 Slack API 入口

前往 api.slack.com/apps，點擊 Create New App。

選擇建立方式

選擇 From a manifest（建議使用——這會自動設定所有權限）。從下拉選單中選擇工作區，然後點擊 Next。

切換到 JSON 分頁，將所有內容替換為以下 manifest，然後點擊 Next。

您可以自訂 name 和 display_name 欄位來為機器人取名（例如「我的 AI 助理」）。description 和 assistant_description 欄位也可以修改來描述您的機器人。

{
  "display_information": {
    "name": "Claw Buff",
    "description": "AI agent powered by Claw Buff"
  },
  "features": {
    "bot_user": {
      "display_name": "Claw Buff",
      "always_online": false
    },
    "assistant_view": {
      "assistant_description": "AI agent powered by Claw Buff"
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "users:read",
        "app_mentions:read",
        "assistant:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "assistant_thread_started",
        "message.im"
      ]
    },
    "socket_mode_enabled": true
  }
}

檢視摘要後，點擊 Create。

取得 Token

您需要兩組 Token：

Bot Token：

前往側邊欄的 OAuth & Permissions
點擊 Install to <your workspace> → Allow
複製 Bot User OAuth Token（以 xoxb- 開頭）

App Token：

前往 Basic Information → App-Level Tokens
點擊 Generate Token and Scopes
命名（例如「socket」），新增範圍 connections:write
點擊 Generate 並複製 Token（以 xapp- 開頭）

步驟 2：連接至 Claw Buff

開啟 Claw Buff 管理後台 → 頻道頁面
找到 Slack 卡片並點擊連接
貼上兩組 Token：
- Bot Token（xoxb-...）
- App Token（xapp-...）
點擊儲存並啟用

機器人將透過 Socket Mode 連線——不需要公開 URL 或 Webhook。

步驟 3：配對您的帳號

機器人開始回應之前，您需要先配對 Slack 帳號：

私訊機器人 — 在 Slack 側邊欄的「應用程式」下找到您的機器人，傳送任意訊息（例如「hello」）
機器人會回覆一組配對碼（例如 7EPLYS7R）
前往 Claw Buff 管理後台 → 頻道頁面
您會看到待處理的配對請求區塊 — 點擊配對碼旁的核准

核准後，機器人將立即回應您的訊息。

配對碼會在 1 小時後過期。如果已過期，只需再次向機器人傳送訊息即可取得新的配對碼。

步驟 4：啟用頻道（選填）

預設情況下，機器人僅在私訊中運作。若要在 Slack 頻道中使用：

在 Slack 中，右鍵點擊頻道名稱 → 查看頻道詳細資訊 → 複製面板底部的頻道 ID

如果看不到頻道 ID，請開啟頻道詳細資訊並捲動至最底部——它會顯示為類似 C07V1ABC123 的字串。

在管理後台，前往頻道 → 點擊 Slack 卡片上的管理
在已授權頻道下方，貼上頻道 ID 並點擊新增
在 Slack 中，邀請機器人加入頻道：輸入 /invite @YourBotName

機器人現在會回應該頻道中的 @提及。您可以新增多個頻道。

步驟 5：開始聊天

私訊機器人 — 在 Slack 側邊欄的「應用程式」下找到您的機器人
在頻道中提及 — 輸入 @YourBotName 加上您的訊息
App Home — 開啟機器人的 App Home 分頁，享有專屬的聊天介面

Socket Mode 表示 Agent 會主動向外連線至 Slack——不需要設定防火牆、反向代理或公開 URL。開箱即用。

功能一覽

功能	支援狀態
私人訊息	是
頻道提及	是
串流回應	是（原生 Slack 串流）
斜線指令	是
App Home	是
討論串回覆	是
豐富格式	是（Block Kit / mrkdwn）

常見問題

1. 機器人沒有回應？

檢查兩組 Token — 您需要 Bot Token（xoxb-）和 App Token（xapp-）
檢查 Socket Mode — 確認 Slack 應用程式設定中已啟用 Socket Mode
檢查管理後台 — 頻道頁面會顯示連線狀態與錯誤紀錄

2. 機器人不回應私訊？

確認以下範圍已設定：im:history、im:read、im:write。如果您使用了上方的 manifest，這些已經包含在內。

3. 機器人不回應頻道中的提及？

機器人需要先被邀請加入頻道（輸入 /invite @Claw Buff）
確認已設定 app_mentions:read 和 channels:history 範圍

4. 出現「not_allowed_token_type」錯誤？

您可能把 Bot Token 和 App Token 填反了。Bot Token 以 xoxb- 開頭，App Token 以 xapp- 開頭。