本文档从更新 OpenClaw 开始，介绍如何将 OpenClaw 接入飞书机器人。
一、更新 OpenClaw
openclaw update
如果已经接入过第三方飞书插件，需要先删除旧配置：
rm -rf ~/.openclaw/extensions/feishu如果没有接入过，忽略此步骤。
二、创建飞书机器人
2.1 创建应用
- 访问 飞书开发者后台
- 点击「创建企业自建应用」
- 填写应用名称和描述（随意填写即可）
2.2 添加机器人能力
- 进入应用，选择「添加应用能力」
- 在右侧「按能力添加」菜单中找到「机器人」
- 点击添加
2.3 开通权限
进入「权限管理」，开通以下权限：
在“权限”页面，点击“批量导入”并粘贴：
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"event:ip_list",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}
三、配置 OpenClaw
3.1 添加飞书渠道
openclaw channels add
在列表中选择 feishu。
3.2 处理已有配置
如果出现 Feishu already configured，选择「修改配置」。
3.3 配置参数
按提示依次配置：
| 配置项 | 说明 |
|---|---|
| Feishu account | 选择 default |
| domain | 根据区域选择（国内选 feishu，国际选 lark） |
| App ID | 在飞书开发者后台「凭据与基础信息」页面获取 |
| App Secret | 同上 |
填写完成后选择 finish。
3.4 后续配置选项
Configure DM access policies now? → 选 No
Add display names for these accounts? → 选 No
3.5 重启 Gateway
openclaw gateway restart
四、配置飞书事件订阅
回到飞书开发者后台：
- 选择「事件与回调」
- 添加事件：
im.message.receive_v1 - 订阅方式选择「使用长连接接收事件」
五、验证
现在可以在飞书中使用 OpenClaw 了！
找到你创建的机器人应用，发送消息测试是否正常响应。
六、常用命令
openclaw update
openclaw channels add
openclaw gateway restart
openclaw gateway status
openclaw logs --follow
