飞书（Lark）是企业级团队协作平台。OpenClaw 通过飞书 WebSocket 长连接接收事件，无需暴露公网 Webhook URL，开箱即用，内置于当前 OpenClaw 版本。
接入方式（二选一）
方式 1：引导向导（推荐）
bash
openclaw onboard向导引导创建飞书应用、收集凭证并完成配置。
方式 2：CLI 添加
bash
openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret7 步创建飞书应用
1. 打开飞书开放平台
2. 创建企业自建应用
填写应用名称、描述，选择图标。
3. 获取凭证
从「凭证与基础信息」复制：
- App ID（格式：
cli_xxx） - App Secret
4. 配置权限（批量导入）
在「权限管理」点击「批量导入」，粘贴以下 JSON：
json
{
"scopes": {
"tenant": [
"im:message",
"im:message:send_as_bot",
"im:message:readonly",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:chat.members:bot_access",
"im:resource",
"contact:user.employee_id:readonly"
],
"user": ["im:chat.access_event.bot_p2p_chat:read"]
}
}5. 启用机器人能力
「应用能力」→「机器人」，启用并设置机器人名称。
6. 配置事件订阅
注意：配置前确保 Gateway 已在运行（
openclaw gateway status）
「事件订阅」→ 选择「使用长连接接收事件（WebSocket）」→ 添加事件 im.message.receive_v1
7. 发布应用
「版本管理与发布」→ 创建版本 → 提交审核 → 发布（企业自建应用通常自动审批）。
配置 OpenClaw
json
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "xxx",
"botName": "我的 AI 助手"
}
}
}
}
}环境变量方式：
bash
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"Lark 国际版配置：
json
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": { "main": { "appId": "cli_xxx", "appSecret": "xxx" } }
}
}
}完成配对
bash
openclaw gateway
# 在飞书中找到机器人发送消息
openclaw pairing approve feishu <CODE>访问控制
DM 策略
| 策略 | 说明 |
|---|---|
pairing（默认） | 未知用户收到配对码，需审批 |
allowlist | 仅 allowFrom 中的 Open ID（ou_xxx） |
open | 允许所有用户 |
disabled | 禁用 DM |
群组控制示例
json
{
"channels": {
"feishu": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["oc_xxx"],
"groups": {
"oc_xxx": {
"requireMention": false,
"allowFrom": ["ou_user1", "ou_user2"]
}
}
}
}
}获取 ID
群组 ID（oc_xxx）：启动 Gateway 后在群里 @ 机器人，查看 openclaw logs --follow 中的 chat_id。
用户 ID（ou_xxx）：DM 机器人后查看日志中的 open_id，或运行 openclaw pairing list feishu。
多 Agent 路由
json
{
"agents": {
"list": [
{ "id": "main" },
{ "id": "sales", "workspace": "~/.openclaw/workspace-sales" }
]
},
"bindings": [
{ "agentId": "main", "match": { "channel": "feishu", "peer": { "kind": "direct", "id": "ou_xxx" } } },
{ "agentId": "sales", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "oc_yyy" } } }
]
}流式卡片回复
json
{
"channels": {
"feishu": {
"streaming": true,
"blockStreaming": true
}
}
}开启后 Bot 在生成回复时实时更新飞书消息卡片，效果类似流式对话。
支持的消息类型
| 方向 | 支持类型 |
|---|---|
| 接收 | 文本、富文本、图片、文件、音频、视频、贴纸 |
| 发送 | 文本、图片、文件、音频（富文本部分支持） |
故障排查
群里不响应：确认 Bot 已加入群组；默认需要 @ 提及；检查 groupPolicy 不是 disabled
收不到消息：确认应用已发布；事件订阅包含 im.message.receive_v1；长连接模式已启用；权限完整
App Secret 泄露：在飞书开放平台重置，更新配置后重启 Gateway
原文：Feishu - OpenClaw | 来源：OpenClaw 官方文档