飞书（海外版称为Lark）是字节跳动推出的企业协作平台，集成了即时通讯、文档协作、视频会议等功能。OpenClaw通过插件系统支持飞书频道，让你可以在飞书中直接与AI代理对话，实现智能客服、知识问答、工作流自动化等场景。
前置准备
在开始配置之前，你需要准备以下内容：
- 一个已部署并正常运行的OpenClaw实例
- 飞书开放平台的企业自建应用（需要管理员权限创建）
- 应用的App ID和App Secret
- 配置好的事件订阅回调地址（需要公网可访问的URL）
创建飞书自建应用
首先登录飞书开放平台（open.feishu.cn），进入开发者后台。点击「创建企业自建应用」，填写应用名称和描述。创建完成后，在应用的「凭证与基础信息」页面可以获取App ID和App Secret，这两个值后续配置时需要用到。
接下来需要为应用添加「机器人」能力。在应用的「添加应用能力」中选择「机器人」，这样应用才能在飞书聊天中收发消息。
配置权限与事件订阅
在应用的「权限管理」页面，需要开通以下权限：
im:message— 获取与发送消息im:message.group_at_msg— 接收群聊中@机器人的消息im:message.p2p_msg— 接收单聊消息im:resource— 获取消息中的资源文件
在「事件订阅」页面，配置请求地址为你的OpenClaw实例的飞书webhook端点。OpenClaw的飞书插件默认监听路径为 /webhooks/feishu，所以完整地址类似 https://your-domain.com/webhooks/feishu。
需要订阅的事件包括：im.message.receive_v1（接收消息事件）。配置完成后飞书会发送一个验证请求，OpenClaw插件会自动处理这个验证。
安装飞书插件
OpenClaw的飞书频道通过插件系统提供。首先安装插件：
openclaw plugin install feishu
安装完成后，可以通过交互式命令进行登录配置：
openclaw channels login feishu
系统会依次提示你输入App ID、App Secret以及Verification Token（可在事件订阅页面找到）。这些凭证会被安全地存储在本地配置中。
手动配置openclaw.json
你也可以直接编辑 openclaw.json 配置文件来设置飞书频道：
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxxxxxxx",
"appSecret": "your-app-secret",
"verificationToken": "your-verification-token",
"encryptKey": "your-encrypt-key"
}
}
}
其中 encryptKey 是可选的，如果在飞书开放平台配置了Encrypt Key则需要填写。启用加密可以增强数据传输的安全性，建议在生产环境中开启。
发布与测试
配置完成后，回到飞书开放平台，将应用的可用范围设置为目标用户或部门，然后点击「创建版本」并提交发布审核。如果是企业内部使用，管理员可以直接审核通过。
发布成功后，在飞书的聊天列表中搜索你的机器人名称，发送一条消息测试是否正常响应。
群聊中使用
将机器人添加到飞书群聊中后，默认情况下机器人只会响应@它的消息。你可以在配置中调整这个行为：
{
"channels": {
"feishu": {
"groupBehavior": "mention_only"
}
}
}
groupBehavior 支持 mention_only（仅响应@消息）和 all（响应所有消息）两种模式。在人数较多的群聊中建议使用 mention_only 模式，避免不必要的干扰。
安全配置
建议通过OpenClaw的allowlist功能限制哪些用户可以与机器人交互：
{
"channels": {
"feishu": {
"allowlist": ["user_id_1", "user_id_2"]
}
}
}
也可以配合OpenClaw的私信配对功能，要求用户先通过私信验证身份后才能在群聊中使用机器人。
与其他频道共存
飞书频道可以与OpenClaw支持的其他频道同时运行。所有频道共享同一个AI模型后端，用户在飞书中的对话与在Telegram、Discord等平台上的对话互不干扰，但可以共享同一套知识库和工具配置。这使得企业可以同时为内部员工（通过飞书）和外部客户（通过其他平台）提供AI服务。
常见问题
如果机器人无法收到消息，请检查事件订阅的回调地址是否正确、应用是否已发布、以及网络防火墙是否放行了飞书服务器的请求。飞书开放平台的「事件订阅」页面提供了日志功能，可以查看事件推送的状态和错误信息。