Điều kiện tiên quyết
- Một tài khoản DingTalk với quyền quản trị viên doanh nghiệp
- Một instance Claw (tạo tại đây)
Hướng dẫn thiết lập
Tạo một ứng dụng DingTalk
- Truy cập DingTalk Open Platform
- Nhấp vào Application Development → Enterprise Internal Development
- Nhấp vào Create Application
- Nhập tên và mô tả ứng dụng
- Nhấp vào Confirm
Bật tính năng Robot
- Trong ứng dụng của bạn, đi tới App Features → Robot
- Bật cấu hình robot
- Chọn Stream Mode (khuyên dùng — không cần URL công khai)
- Nhấp vào Publish
Xuất bản ứng dụng
- Đi tới Version Management
- Tạo một phiên bản mới (tối thiểu là phiên bản thử nghiệm)
- Thiết lập phạm vi hiển thị (người dùng/phòng ban nào có thể thấy bot)
- Gửi và xuất bản
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
- Mở rộng phần DingTalk
- Dán AppKey và AppSecret của bạn
- Nhấp vào Save
Cài đặt nhóm
Cấu hình hành vi trò chuyện nhóm 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 ai có thể kích hoạt bot trong nhóm |
| Group Allowed Users | Danh sách user ID | Chỉ những người dùng này mới có thể kích hoạt bot (chế độ allowlist) |
DingTalk luôn yêu cầu @mention để kích hoạt bot trong nhóm — đây là giới hạn của nền tảng và không thể cấu hình. Lọc theo Group ID không khả dụng cho DingTalk; hãy sử dụng cài đặt Group Policy để kiểm soát quyền truy cập.
Khắc phục sự cố
Bot không phản hồi
Bot không phản hồi
- Xác minh AppKey và AppSecret là chính xác
- Kiểm tra xem ứng dụng đã được xuất bản chưa (ít nhất là phiên bản thử nghiệm)
- Đảm bảo chế độ Stream đã được chọn trong cấu hình robot
- Xác minh bot hiển thị với tài khoản người dùng của bạn
Kết nối bị ngắt thường xuyên
Kết nối bị ngắt thường xuyên
- Chế độ Stream duy trì kết nối WebSocket liên tục
- Việc ngắt kết nối ngắn là bình thường — bot sẽ tự động kết nối lại
- Nếu tình trạng kéo dài, hãy thử khởi động lại instance từ dashboard