Thiết lập Bot Discord

Hướng dẫn từng bước kết nối Claw Buff agent với Discord

Kết nối AI Agent Claw Buff với máy chủ Discord. Bot sẽ phản hồi tin nhắn trực tiếp và tin nhắn trong kênh. Quá trình thiết lập mất khoảng 10 phút.

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

Tài khoản Discord
Máy chủ Discord mà bạn có quyền Manage Server
Agent Claw Buff đã được triển khai (Bắt đầu sử dụng)

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

Mở Developer Portal

Truy cập Discord Developer Portal và nhấn New Application. Đặt tên cho ứng dụng (ví dụ: "My AI Agent").

Tạo Bot

Trong thanh bên, nhấn Bot. Tùy chỉnh username và ảnh đại diện cho bot nếu muốn.

Bật Message Content Intent

Cuộn xuống mục Privileged Gateway Intents và bật:

Message Content Intent — Bắt buộc để đọc nội dung tin nhắn
Server Members Intent — Khuyến nghị để kiểm soát truy cập theo vai trò

Nhấn Save Changes.

Sao chép Bot Token

Nhấn Reset Token (hoặc Copy nếu hiển thị) để lấy bot token. Lưu lại — bạn sẽ cần nó ở bước tiếp theo.

Bot token là thông tin bí mật. Tuyệt đối không chia sẻ công khai. Nếu bị lộ, hãy đặt lại ngay trong Developer Portal.

Bước 2: Mời Bot vào máy chủ

Tạo liên kết mời

Trong thanh bên Developer Portal, nhấn OAuth2 → URL Generator.

Chọn các scope sau:

bot
applications.commands

Sau đó chọn các quyền cho bot:

View Channels
Send Messages
Read Message History
Embed Links
Attach Files

Mời bot

Sao chép URL đã tạo và mở trong trình duyệt. Chọn máy chủ bạn muốn thêm bot, sau đó nhấn Authorize.

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

Mở Bảng điều khiển Claw Buff → trang Kênh liên lạc
Tìm thẻ Discord và nhấn Connect
Dán Bot Token từ Bước 1
Nhấn Save & Activate

Bot sẽ trực tuyến trong vài giây.

Bước 4: 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 Discord:

Nhắn tin cho bot — Nhấn vào tên bot trong danh sách thành viên server và gửi tin nhắn bất kỳ (ví dụ: "hello")
Bot sẽ trả về mã ghép nối (ví dụ: X7QTGBD4)
Vào Bảng điều khiển Claw Buff → trang Kênh liên lạc
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 trực tiếp của bạn ngay lập tức.

Bước 5: Bật kênh trong máy chủ (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 máy chủ:

Trong Discord, nhấn chuột phải vào biểu tượng máy chủ → Copy Server ID

Nếu không thấy "Copy Server ID", hãy bật Developer Mode trước: User Settings → Advanced → bật Developer Mode.

Trong Bảng điều khiển, vào Kênh liên lạc → nhấn Manage trên thẻ Discord
Trong mục Authorized Servers, dán Server ID và nhấn Add

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

Khi mention bot, hãy đảm bảo bạn chọn người dùng bot (hiển thị trong mục "Members" với nhãn APP), không phải vai trò cùng tên. Discord tạo một vai trò trùng tên với bot — mention vai trò sẽ không kích hoạt phản hồi.

Tính năng

Tính năng	Hỗ trợ
Tin nhắn trực tiếp	Có
Tin nhắn trong kênh	Có (cần mention)
Phản hồi trực tuyến	Có (chỉnh sửa theo thời gian thực)
Slash Commands	Có
Rich Embeds	Có
Tệp đính kèm	Có
Kênh thoại	Có

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

1. Bot hiển thị ngoại tuyến trên Discord?

Kiểm tra token — Đảm bảo bạn đã dán đầy đủ token
Kiểm tra intents — Message Content Intent phải được bật trong Developer Portal
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?

Đảm bảo Message Content Intent đã được bật (Bước 1)
Trong kênh, bot yêu cầu @mention để phản hồi
Đảm bảo bạn mention người dùng bot, không phải vai trò — Khi gõ @, chọn bot từ mục "Members" (có nhãn APP), không phải từ mục "Roles". Discord tạo vai trò trùng tên với bot, nhưng mention vai trò sẽ không kích hoạt phản hồi.
Kiểm tra bot có quyền View Channels và Read Message History trong kênh

3. Lỗi "Missing Permissions"?

Bot cần đủ quyền trong kênh. Kiểm tra bot có tối thiểu các quyền: View Channels, Send Messages, Read Message History và Embed Links.