飞书（国际版 Lark）是字节跳动旗下的企业协作平台，在国内外企业中广泛使用。OpenClaw 通过 WebSocket 长连接接收飞书事件，无需暴露公网 Webhook URL——这对内网部署非常友好。
核心优势
飞书插件使用 WebSocket 事件订阅，无需公网 HTTPS 端点，Gateway 主动建立到飞书服务器的连接，非常适合：
- 内网/家庭网络部署
- 不想处理 HTTPS 证书的场景
- 防火墙限制入站连接的环境
支持功能
- ✅ 私信（Direct Messages）
- ✅ 群聊（Group Chats）
- ✅ 富文本消息（卡片、Markdown）
- ✅ 文件和图片接收
- ✅ 多账号支持
- ✅ 流式消息分块
第一步：安装飞书插件
openclaw plugins install @openclaw/feishu第二步：在飞书开放平台创建应用
方式一：向导引导（推荐）
openclaw onboard选择飞书，向导会引导你完成创建应用、填写凭据、启动 Gateway 的全流程。
方式二：手动创建
1. 打开飞书开放平台
访问 open.feishu.cn（国内）或 open.larksuite.com（国际/Lark）。
2. 创建应用
进入「开发者后台」→「创建企业自建应用」，填写应用名称和描述。
3. 获取凭据
在应用详情页的「凭证与基础信息」中获取：
App ID（即appId）App Secret（即appSecret）
4. 配置权限
在「权限管理」中开启：
im:message（接收和发送消息）im:message.group_at_msg（接收群组 @消息）- 根据需要开启文件、图片等相关权限
5. 启用机器人能力
在「应用功能」→「机器人」中开启机器人功能。
6. 配置事件订阅
在「事件订阅」中：
- 选择「使用长连接接收事件」（推荐，无需公网 URL）
- 订阅
im.message.receive_v1事件
7. 发布应用
提交发布申请，管理员审批后生效（自建应用可能需要企业管理员批准）。
第三步：配置 OpenClaw
最简配置
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxxx",
"appSecret": "your-app-secret",
"dmPolicy": "pairing"
}
}
}使用环境变量
export FEISHU_APP_ID="cli_xxxxxx"
export FEISHU_APP_SECRET="your-app-secret"Lark（国际版）域名配置
{
"channels": {
"feishu": {
"appId": "cli_xxxxxx",
"appSecret": "your-secret",
"domain": "larksuite"
}
}
}访问控制
私信策略
pairing（默认）：未知用户收到配对码，审批后才能正常对话
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>open：允许所有人
allowlist：只允许指定用户（用 open_id 标识）
群组配置示例
允许所有群组，需要 @提及（默认）：
{
"channels": {
"feishu": {
"groupPolicy": "open",
"groups": {
"*": { "requireMention": true }
}
}
}
}允许所有群组，无需 @提及：
{
"channels": {
"feishu": {
"groupPolicy": "open",
"groups": {
"*": { "requireMention": false }
}
}
}
}只允许特定群组：
{
"channels": {
"feishu": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["oc_xxxx"]
}
}
}允许特定用户在群组中执行控制命令（/reset、/new 等）：
{
"channels": {
"feishu": {
"groups": {
"oc_xxxx": {
"adminUsers": ["ou_xxxx"]
}
}
}
}
}获取 ID
群组 ID（chat_id）：发一条消息给 Bot，在日志中查看 chat_id 字段，通常以 oc_ 开头。
用户 ID（open_id）：Bot 收到消息后在日志中可以看到发件人的 open_id，通常以 ou_ 开头。
流式消息配置
{
"channels": {
"feishu": {
"streaming": {
"blockStreaming": false,
"chunkMinBytes": 50
}
}
}
}常见问题排查
Bot 在群聊中不响应？
检查是否已开启 im:message.group_at_msg 权限，以及群组配置中 requireMention 的设置。
Bot 收不到消息？
确认事件订阅中选择了「长连接」模式，且已订阅 im.message.receive_v1 事件。检查 openclaw logs --follow 查看连接状态。
App Secret 泄露？ 立即在飞书开放平台重置 App Secret，更新配置文件，重启 Gateway。
原文：Feishu - OpenClaw | 来源：OpenClaw 官方文档