Điều kiện tiên quyết
- Một tài khoản Feishu hoặc Lark có quyền truy cập dành cho nhà phát triển
- Một instance Claw (tạo một cái tại đây)
Hướng dẫn thiết lập
Tạo một ứng dụng Feishu
- Truy cập Feishu Open Platform (hoặc Lark Developer)
- Nhấp vào Create Custom App
- Nhập tên và mô tả ứng dụng
- Nhấp vào Create
Thêm khả năng Bot
- Trong cài đặt ứng dụng, đi tới Features → Bot
- Kích hoạt khả năng bot
- Điều này cho phép ứng dụng của bạn nhận và gửi tin nhắn
Lấy thông tin xác thực
- Đi tới Credentials & Basic Info
- Sao chép App ID (bắt đầu bằng
cli_) - Sao chép App Secret
Cấu hình Đăng ký Sự kiện
- Đi tới Event Subscriptions
- Chọn chế độ WebSocket (được khuyến nghị — không cần URL công khai)
- Nếu được nhắc, hãy thiết lập Encrypt Key và Verification Token
Thêm Quyền Sự kiện
- Trong mục Event Subscriptions, thêm các sự kiện sau:
im.message.receive_v1— Nhận tin nhắn
- Đi tới Permissions & Scopes và thêm:
im:message— Gửi và nhận tin nhắnim:message.group_at_msg— Nhận các lượt @nhắc_tên trong nhóm
- Nhấp vào Save
Phát hành Ứng dụng
- Đi tới App Release → Version Management
- Tạo một phiên bản mới
- Gửi để phê duyệt (đối với các ứng dụng nội bộ, việc này thường diễn ra tức thì)
- Sau khi được phê duyệt, ứng dụng sẽ hoạt động
Cấu hình trong LemonData Dashboard
- Đi tới 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 Feishu
- Dán App ID và App Secret của bạn
- Sao chép Encrypt Key và Verification Token được tạo tự động quay lại Feishu developer console
- 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ả |
|---|---|---|
| Chính sách Nhóm | Mở (mặc định) / Allowlist / Đã tắt | Kiểm soát ai có thể kích hoạt bot trong các nhóm |
| Yêu cầu @nhắc_tên | Bật / Tắt | Bot chỉ phản hồi khi được @nhắc_tên |
| ID Nhóm | Danh sách chat ID | Giới hạn trong các nhóm cụ thể (để trống = tất cả các nhóm) |
| Người dùng Nhóm được phép | Danh sách Open ID | Chỉ những người dùng này mới có thể kích hoạt bot (chế độ allowlist) |
Xử lý sự cố
Bot không nhận được tin nhắn
Bot không nhận được tin nhắn
- Xác minh rằng ứng dụng đã được phát hành và phê duyệt
- Kiểm tra xem sự kiện
im.message.receive_v1đã được đăng ký chưa - Đảm bảo đã chọn chế độ WebSocket (không phải HTTP)
- Xác minh Encrypt Key và Verification Token khớp nhau giữa Feishu console và cấu hình Claw
Lỗi 'app_ticket'
Lỗi 'app_ticket'
- Điều này thường có nghĩa là App ID hoặc App Secret không chính xác
- Kiểm tra kỹ lại thông tin xác thực trong dashboard của bạn