Thiết lập Bot Slack

Kết nối AI Agent Claw Buff với không gian làm việc Slack. Bot sẽ phản hồi tin nhắn trực tiếp, mention và lệnh slash /claw. Quá trình thiết lập mất khoảng 10 phút.

Yêu cầu trước khi bắt đầu

• Không gian làm việc Slack mà bạn có quyền quản trị (hoặc quyền cài đặt ứng dụng)
• Agent Claw Buff đã được triển khai (Bắt đầu sử dụng)

Bước 1: Tạo ứng dụng Slack

{
  "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
  }
}

Bước 2: Kết nối với Claw Buff

1. Mở Bảng điều khiển Claw Buff → trang Kênh liên lạc
2. Tìm thẻ Slack và nhấn Connect
3. Dán cả hai token:
   • Bot Token (xoxb-...)
   • App Token (xapp-...)
4. Nhấn Save & Activate

Bot sẽ kết nối qua Socket Mode — không cần URL công khai hay webhook.

Bước 3: Ghép nối tài khoản

Trước khi bot phản hồi, bạn cần ghép nối tài khoản Slack:

1. Nhắn tin cho bot — Tìm bot trong thanh bên Slack dưới mục Apps và gửi tin nhắn bất kỳ (ví dụ: "hello")
2. Bot sẽ trả về mã ghép nối (ví dụ: 7EPLYS7R)
3. Vào Bảng điều khiển Claw Buff → trang Kênh liên lạc
4. Bạn sẽ thấy mục Pending Pairing Requests — nhấn Approve bên cạnh mã

Sau khi phê duyệt, bot sẽ phản hồi tin nhắn của bạn ngay lập tức.

Bước 4: Bật kênh (Tùy chọn)

Mặc định, bot chỉ hoạt động qua tin nhắn trực tiếp. Để sử dụng trong kênh Slack:

1. Trong Slack, nhấn chuột phải vào tên kênh → View channel details → sao chép Channel ID ở cuối bảng thông tin

2. Trong Bảng điều khiển, vào Kênh liên lạc → nhấn Manage trên thẻ Slack
3. Trong mục Authorized Channels, dán Channel ID và nhấn Add
4. Trong Slack, mời bot vào kênh: gõ /invite @YourBotName

Bot sẽ phản hồi khi được @mention trong kênh đó. Bạn có thể thêm nhiều kênh.

Bước 5: Bắt đầu trò chuyện

• Nhắn tin trực tiếp — Tìm bot trong thanh bên Slack dưới mục Apps
• Mention trong kênh — Gõ @YourBotName kèm nội dung tin nhắn
• App Home — Mở tab App Home của bot để có giao diện trò chuyện riêng

Tính năng

Câu hỏi thường gặp

1. Bot không phản hồi?

• Kiểm tra cả hai token — Bạn cần cả Bot Token (xoxb-) và App Token (xapp-)
• Kiểm tra Socket Mode — Đảm bảo Socket Mode đã được bật trong cài đặt ứng dụng Slack
• Kiểm tra Bảng điều khiển — Trang Kênh liên lạc hiển thị trạng thái kết nối và nhật ký lỗi

2. Bot không phản hồi tin nhắn trực tiếp?

Đảm bảo các scope sau đã được cấp: im:history, im:read, im:write. Nếu bạn sử dụng manifest ở trên, các scope này đã được bao gồm sẵn.

3. Bot không phản hồi khi mention trong kênh?

• Bot cần được mời vào kênh trước (gõ /invite @Claw Buff)
• Đảm bảo đã có các scope app_mentions:read và channels:history

4. Lỗi "not_allowed_token_type"?

Có thể bạn đã nhập nhầm vị trí Bot Token và App Token. Bot Token bắt đầu bằng xoxb- còn App Token bắt đầu bằng xapp-.