一、操作流程
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,搜索机器人名称,即可与机器人开始对话。