OpenClaw 飞书平台配置指南

快速配置飞书机器人，实现消息接收与发送。

一、开始前确认

在进入飞书开放平台前，建议先在服务器完成以下前置步骤。

在 1Panel 平台安装 OpenClaw

二、操作步骤

1）创建企业自建应用

打开飞书开放平台 https://open.feishu.cn/app，点击“创建企业自建应用”，填写名称、描述和图标。

飞书后台创建应用入口。

2）复制应用凭证

进入“凭证与基础信息”，复制并保存 App ID（例如 cli_xxx）和 App Secret。

请妥善保管 App Secret，避免泄露。

3）批量导入应用权限

在“权限管理”页点击“批量导入”，粘贴下方权限 JSON（官方推荐），然后提交。

{ "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "contact:contact.base:readonly", "im:chat.access_event.bot_p2p_chat:read" ] } }

导入后请检查关键权限是否都在“已申请”状态。

4）启用机器人能力

打开“应用能力 > 机器人”，启用机器人并设置机器人名称。

机器人名称建议与 OpenClaw 应用场景保持一致。

5）在 1Panel 中配置飞书

打开“智能体 > 配置”，在聊天渠道中启用飞书，并填写 App ID 和 App Secret。

6）配置事件订阅（长连接）

进入“事件订阅”，选择“使用长连接接收事件（WebSocket）”，并添加事件 im.message.receive_v1。

若保存失败，优先检查 OpenClaw 网关是否正在运行。

7）发布应用

在“版本管理与发布”中创建版本并提交发布，等待企业管理员审批（企业自建应用通常可快速通过）。

三、发布后快速验证

在飞书中找到机器人，发送一条测试消息。
如果收到配对码，在 1Panel 中填写配对码并保存。
如果没有收到配对码，直接可以对话，则无须后续步骤。

随后再发送消息即可正常对话。若异常，可查看容器日志排查问题。