Điều kiện tiên quyết
- Một tài khoản QQ
- Quyền truy cập vào QQ Open Platform (tài khoản nhà phát triển)
- Một instance Claw (tạo tại đây)
Hướng dẫn thiết lập
Tạo ứng dụng QQ Bot
- Truy cập QQ Open Platform
- Đăng nhập và đi tới phần Bot
- Nhấp vào Create Bot
- Điền thông tin bot (tên, ảnh đại diện, mô tả)
- Gửi để xét duyệt
Lấy thông tin xác thực
- Sau khi được phê duyệt, hãy đi tới Development Settings của bot
- Sao chép AppID
- Sao chép AppSecret (Client Secret)
Cấu hình Sandbox (để thử nghiệm)
- Trong cài đặt bot, đi tới Sandbox Configuration
- Thêm số QQ của bạn vào whitelist của sandbox
- Điều này cho phép bạn thử nghiệm trước khi triển khai thực tế
Cấu hình trong LemonData Dashboard
- 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
- Expand phần QQ
- Dán AppID và AppSecret của bạn
- Nhấp vào Save
Các loại tin nhắn được hỗ trợ
| Loại | Mô tả |
|---|---|
| C2C (Cá nhân) | Tin nhắn trực tiếp đến bot |
| Group @mention | @mention bot trong một nhóm QQ |
| Channel | Tin nhắn trong các kênh QQ (频道) |
Xử lý sự cố
Bot không phản hồi
Bot không phản hồi
- Xác minh AppID và AppSecret là chính xác
- Kiểm tra xem số QQ của bạn đã có trong whitelist của sandbox chưa (nếu đang thử nghiệm)
- Đảm bảo ứng dụng bot đã được phê duyệt
Lỗi 'invalid appid'
Lỗi 'invalid appid'
- Kiểm tra lại AppID — nó phải là một chuỗi số
- Đảm bảo bạn đang sử dụng đúng AppSecret (không phải token)