Điều kiện tiên quyết
- Một tài khoản quản trị WeCom
- Một instance Claw (tạo tại đây)
Hướng dẫn thiết lập
Tạo một ứng dụng WeCom
- Đăng nhập vào WeCom Admin Console
- Đi tới App Management → Create App
- Nhập tên ứng dụng, tải lên logo và thiết lập phạm vi hiển thị (visible range)
- Nhấp vào Create
Lấy thông tin xác thực
- Ghi lại Corp ID — tìm thấy tại My Enterprise → Enterprise Info ở phía dưới cùng
- Trong cài đặt ứng dụng, sao chép Secret (Corp Secret)
Cấu hình Callback URL
- Trong cài đặt ứng dụng, đi tới Receive Messages → Set API Receive
- Callback URL của bạn được hiển thị trong dashboard LemonData khi bạn mở rộng phần WeCom:
- Thiết lập một Token (chuỗi ngẫu nhiên) và EncodingAESKey (chuỗi ngẫu nhiên 43 ký tự)
- Nhấp vào Save — WeCom sẽ xác minh callback URL
Mở LemonClaw WebUI
- Nếu bạn dùng Claw hosted, hãy vào Claw Dashboard rồi nhấp Open WebUI
- Nếu bạn self-host LemonClaw, hãy mở WebUI của riêng bạn (ví dụ
http://your-ip:18789) và đăng nhập bằng token - Trong WebUI, vào Settings → Channels
- Mở rộng phần WeCom
- Sao chép Callback URL được hiển thị ở trên cùng
- Điền vào: Corp ID, Corp Secret, Token, EncodingAESKey
- Nhấp vào Save
Khắc phục sự cố
Hỗ trợ WeCom hiện tại trong LemonClaw vẫn là nhắn tin 1:1 theo người dùng. Hỗ trợ đầy đủ cho mention nhóm, thread và reply vẫn chưa có.
Xác minh Callback URL thất bại
Xác minh Callback URL thất bại
- Đảm bảo instance Claw của bạn đang hoạt động (trạng thái màu xanh)
- Xác minh định dạng URL:
https://claw-{subdomain}.lemondata.cc/webhook/wecom - Kiểm tra xem Token và EncodingAESKey đã được lưu trong cấu hình Claw trước khi xác minh trong WeCom hay chưa
Bot không phản hồi
Bot không phản hồi
- Xác minh Corp ID và Corp Secret là chính xác
- Kiểm tra xem ứng dụng có hiển thị với tài khoản người dùng của bạn hay không (thiết lập visible range)
- Đảm bảo Token và EncodingAESKey khớp nhau giữa WeCom và Claw