前提条件
1. 已通过云应用安装部署 OpenClaw,详细部署教程参考 通过云应用快速部署 OpenClaw。
2. 已注册飞书,并具备企业管理员权限。如尚未注册飞书,请前往 飞书官网 注册。
操作流程
1. 登录 飞书开放平台。
2. 进入开发者后台,选择创建企业自建应用。填写“应用名称”和“应用描述”完成创建。


3. 进入应用,选择配置机器人。填写机器人配置信息,完成后单击保存。


4. 在左侧菜单选择权限管理,单击批量导入权限。

5. 复制下方代码,粘贴导入,单击确认新增权限,完成开通。
{"scopes": {"tenant": ["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","cardkit:card:read","cardkit:card: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"]}}


6. 在左侧菜单选择凭证与基础信息,获取 App ID 与 App Secret,后续步骤中将会使用。

7. 飞书通道配置。
7.1 前往 云应用-应用总览页,找到已部署的应用。
7.2 选择云服务器实例,找到已创建的云服务器实例。


7.3 单击实例资源 ID,进入实例控制台,选择 OrcaTerm 登录。

7.4 进入界面后,若首次添加通道,输入 openclaw plugins install @openclaw/feishu 命令行,安装通道插件。

安装完成后输入 openclaw gateway restart 命令行,重启网关。

若 之前已安装过插件 或 按照上述指南完成安装插件命令后,输入 openclaw channels add 命令行,选择开始添加通道。

7.5 在选择通道步骤,选择 Feishu/Lark(飞书)。

7.6 将第5步获取的 App Secret 和 App ID 依次输入(请注意输入顺序)。

7.7 飞书连接测试成功后,依照下图配置连接方式、连接站点、群聊策略。

7.8 配置完成后,命令会自动重新跳转至选择通道,选择 Finished。

7.9 按照下方选项进行私聊 DM 访问策略配置,即可完成飞书通道配置。

8. 返回飞书,在左侧菜单选择事件与回调,选择订阅方式为长链接,单击保存。
如您前序配置未成功,则可能无法保存订阅方式。请重新在云服务器内尝试通道配置或输入 openclaw gateway status 命令行,排查网关状态。

单击添加事件,输入 im.message.receive_v1 后确认添加。

9. 在左侧菜单选择版本管理与发布,填写“版本号”“更新说明”“可用范围”等信息,单击保存即可提交发布。发布免审核,提交发布后即可上线使用。

10. 打开飞书 APP,搜索机器人名称,即可与机器人开始对话。

