Điều kiện tiên quyết
- Một tài khoản Discord
- Một máy chủ Discord nơi bạn có quyền Quản lý Máy chủ (Manage Server)
- Một instance Claw (tạo tại đây)
Hướng dẫn thiết lập
Tạo một Ứng dụng Discord
- Truy cập Discord Developer Portal
- Nhấp vào New Application
- Đặt tên cho ứng dụng (ví dụ: “My AI Bot”) và nhấp vào Create
Tạo một Bot
- Trong ứng dụng của bạn, đi tới tab Bot
- Nhấp vào Add Bot → Yes, do it!
- Dưới mục Privileged Gateway Intents, hãy bật:
- Message Content Intent (bắt buộc)
- Server Members Intent (khuyên dùng)
- Nhấp vào Reset Token để tạo một bot token
- Sao chép token — bạn sẽ cần nó ở bước tiếp theo
Mời Bot vào Máy chủ của bạn
- Đi tới tab OAuth2 → URL Generator
- Dưới mục Scopes, chọn:
bot,applications.commands - Dưới mục Bot Permissions, chọn:
Send Messages,Read Message History - Sao chép URL đã tạo và mở nó trong trình duyệt của bạn
- Chọn máy chủ của bạn và nhấp vào Authorize
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 Discord
- Dán Bot Token của bạn vào
- Nhấp vào Save
Sử dụng trong Máy chủ
Cài đặt Nhóm
Cấu hình hành vi của máy chủ (guild) 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 quyền truy cập vào các kênh máy chủ |
| Require @mention | Bật / Tắt | Bot chỉ phản hồi khi được @mention (khuyên dùng) |
| Group IDs | Danh sách guild ID | Giới hạn ở các máy chủ cụ thể (để trống = tất cả máy chủ) |
Discord sử dụng allowlist người dùng theo từng guild thay vì allowlist nhóm toàn cầu. Để lọc người dùng nâng cao theo từng guild, hãy cấu hình trực tiếp trong tệp cấu hình OpenClaw.
Chính sách DM
Kiểm soát những ai có thể gửi tin nhắn trực tiếp cho bot của bạn:| Chính sách | Hành vi |
|---|---|
| Pairing (mặc định) | Người dùng mới nhận được mã ghép cặp — nhập mã đó vào WebUI để ủy quyền |
| Allowlist | Chỉ những ID người dùng bạn chỉ định mới có thể DM cho bot |
| Open | Bất kỳ ai cũng có thể DM cho bot (thận trọng khi sử dụng) |
Xử lý sự cố
Bot đang trực tuyến nhưng không phản hồi
Bot đang trực tuyến nhưng không phản hồi
- Đảm bảo Message Content Intent đã được bật trong Developer Portal
- Xác minh bot token là chính xác
- Kiểm tra xem bot có quyền đọc và gửi tin nhắn trong kênh hay không
Bot hiển thị ngoại tuyến
Bot hiển thị ngoại tuyến
- Kiểm tra trạng thái instance trong dashboard (phải là màu xanh/đang chạy)
- Thử khởi động lại instance
- Xác minh rằng token chưa bị reset trong Developer Portal
Lỗi 409 Conflict trong nhật ký (logs)
Lỗi 409 Conflict trong nhật ký (logs)
- Điều này xảy ra khi hai instance cố gắng sử dụng cùng một bot token
- Đảm bảo chỉ có một instance Claw được cấu hình với token này