Điều kiện tiên quyết
- Một không gian làm việc Slack mà bạn có quyền quản trị
- Một instance Claw (tạo tại đây)
Hướng dẫn thiết lập
Tạo một Slack App
- Truy cập Slack API và nhấp vào Create New App
- Chọn From scratch
- Nhập tên ứng dụng (ví dụ: “AI Assistant”) và chọn không gian làm việc của bạn
- Nhấp vào Create App
Bật Socket Mode
- Ở thanh bên trái, đi tới Socket Mode
- Chuyển Enable Socket Mode sang ON
- Đặt tên cho token (ví dụ: “claw-socket”) và nhấp vào Generate
- Sao chép App-Level Token (bắt đầu bằng
xapp-) — bạn sẽ cần mã này
Cấu hình quyền cho Bot
- Đi tới OAuth & Permissions ở thanh bên
- Dưới mục Bot Token Scopes, thêm các scope sau:
chat:write— Gửi tin nhắnim:history— Đọc lịch sử DMim:read— Xem DMim:write— Bắt đầu DMapp_mentions:read— Phát hiện @mention
- Nhấp vào Install to Workspace ở phía trên
- Ủy quyền cho ứng dụng
- Sao chép Bot User OAuth Token (bắt đầu bằng
xoxb-)
Bật Events
- Đi tới Event Subscriptions ở thanh bên
- Chuyển Enable Events sang ON
- Dưới mục Subscribe to bot events, thêm:
message.im— Tin nhắn trong DMapp_mention— @mention trong các kênh
- Nhấp vào Save Changes
Cấu hình trong Dashboard LemonData
- Truy cập Claw Dashboard của bạn
- Nhấp vào biểu tượng cài đặt trên instance của bạn
- Mở tab IM Integrations
- Mở rộng phần Slack
- Dán App Token (
xapp-...) và Bot Token (xoxb-...) của bạn - Nhấp vào Save
Kiểm soát truy cập
Cài đặt nhóm
Cấu hình quyền truy cập kênh trong tab IM Integrations trên Dashboard của bạn:| Cài đặt | Tùy chọn | Mô tả |
|---|---|---|
| Group Policy | Open (mặc định) / Allowlist / Disabled | Kiểm soát các kênh mà bot sẽ phản hồi |
| Require @mention | On / Off | Bot chỉ phản hồi khi được @mention |
| Group IDs | Danh sách ID kênh | Giới hạn ở các kênh cụ thể (để trống = tất cả các kênh) |
| Group Allowed Users | Danh sách ID người dùng | Chỉ những người dùng này mới có thể kích hoạt bot (chế độ allowlist) |
Khắc phục sự cố
Bot không phản hồi DM
Bot không phản hồi DM
- Xác minh cả hai token đều chính xác (App Token bắt đầu bằng
xapp-, Bot Token bằngxoxb-) - Kiểm tra xem event
message.imđã được đăng ký chưa - Đảm bảo ứng dụng đã được cài đặt vào không gian làm việc của bạn
Bot không phản hồi @mention
Bot không phản hồi @mention
- Kiểm tra xem scope
app_mentions:readvà eventapp_mentionđã được cấu hình chưa - Bot phải được mời vào kênh trước (nhập
/invite @botname)
Lỗi 'not_allowed_token_type'
Lỗi 'not_allowed_token_type'
- Đảm bảo bạn đang sử dụng App-Level Token (
xapp-) cho trường App Token, không phải Bot Token - Bot Token (
xoxb-) được điền vào trường Bot Token