Quay lại README

Feishu

Feishu (tên quốc tế: Lark) là nền tảng cộng tác doanh nghiệp của ByteDance. Hỗ trợ cả thị trường Trung Quốc và toàn cầu thông qua kết nối WebSocket theo hướng sự kiện.

Cấu hình

json

{
  "channel_list": {
    "feishu": {
      "enabled": true,
      "type": "feishu",
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    }
  }
}

Trường	Kiểu	Bắt buộc	Mô tả
enabled	bool	Có	Có bật kênh Feishu hay không
app_id	string	Có	App ID của ứng dụng Feishu (bắt đầu bằng `cli_`)
app_secret	string	Có	App Secret của ứng dụng Feishu
encrypt_key	string	Không	Khóa mã hóa cho callback sự kiện
verification_token	string	Không	Token dùng để xác minh sự kiện Webhook
allow_from	array	Không	Danh sách trắng ID người dùng; để trống nghĩa là cho phép tất cả
random_reaction_emoji	array	Không	Danh sách emoji phản ứng ngẫu nhiên; để trống dùng "Pin" mặc định

Hướng dẫn thiết lập

Truy cập Nền tảng Mở Feishu và tạo ứng dụng
Bật khả năng Bot trong cài đặt ứng dụng
Tạo phiên bản và xuất bản ứng dụng (cấu hình có hiệu lực sau khi xuất bản)
Lấy App ID (bắt đầu bằng cli_) và App Secret
Điền App ID và App Secret vào file cấu hình PicoClaw
Chạy picoclaw gateway để khởi động dịch vụ
Tìm kiếm tên bot trong Feishu và bắt đầu trò chuyện

PicoClaw kết nối với Feishu bằng chế độ WebSocket/SDK — không cần cấu hình địa chỉ callback công khai hay Webhook URL.

encrypt_key và verification_token là tùy chọn; nên bật mã hóa sự kiện trong môi trường sản xuất.

Tham khảo emoji tùy chỉnh: Danh sách Emoji Feishu

Giới hạn nền tảng

⚠️ Kênh Feishu không hỗ trợ thiết bị 32 bit. SDK Feishu chỉ cung cấp bản build 64 bit. Các kiến trúc 32 bit (armv6, armv7, mipsle, v.v.) không thể sử dụng kênh Feishu. Để nhắn tin trên thiết bị 32 bit, hãy dùng Telegram, Discord hoặc OneBot.