本文将详细介绍如何在 OpenClaw 中配置飞书(Feishu/Lark)插件,让你的 AI 助手能够通过飞书与用户进行交互。
前置条件:
- ✅ 已安装 OpenClaw
- ✅ 有飞书/ Lark 企业账号
- ✅ 电脑能访问飞书开放平台
打开终端,运行以下命令:
openclaw plugins install @openclaw/feishu
或本地开发版本:
openclaw plugins install ./extensions/feishu
打开浏览器,访问:开发者后台 – 飞书开放平台
登录你的飞书账号。
⚠️ 如果你使用的是 Lark 国际版,请访问:Lark 开放平台
- 点击 「创建企业自建应用」
- 填写应用名称(如:OpenClaw 助手)openclaw skills 教程
- 上传应用图标(可选)
- 点击创建
创建成功后,在应用页面找到 「凭证与基础信息」,复制:
- App ID(格式:
cli_xxx) - App Secret(点击查看,需保密)
在应用详情页,点击左侧 「权限管理」
点击 「批量导入」,粘贴以下权限列表:
{ "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" ] } }
点击导入。
在应用页面,点击 「应用能力」 > 「Bot」
- 开启 「Bot 能力」
- 设置 Bot 名称(如:OpenClaw 助手)
- 添加 Bot 头像(可选)
⚠️ 这一步需要先运行 OpenClaw 配置,请先完成第六步的前半部分,再回来继续。
在应用页面,点击 「事件与回调」
- 选择 「使用长连接接收事件」(WebSocket)
- 点击添加事件
添加以下事件:
im.message.receive_v1– 接收消息
点击确定保存。
运行配置向导:
openclaw onboard
按照提示:
- 选择添加飞书频道
- 输入 App ID 和 App Secret
- 启动 Gateway
编辑配置文件 ~/.openclaw/openclaw.json:
{ "channels": { "feishu": { "enabled": true, "dmPolicy": "pairing", "accounts": { "main": { "appId": "你的App ID", "appSecret": "你的App Secret", "botName": "OpenClaw助手" } } } } }
保存后重启 Gateway:
openclaw gateway restart
在应用页面,点击 「版本管理与发布」
- 点击 「创建新版本」
- 填写版本号(如:1.0.0)
- 填写更新说明
- 提交审核
审核通过后(企业应用通常自动通过),点击 「直接发布」。
openclaw gateway status
确保 Gateway 已启动。
在飞书中搜索你的 Bot 名称,发送一条消息。
如果开启了配对模式,需要批准配对:
openclaw pairing approve feishu <配对码>
配对成功后,就可以开始对话了!
- 检查 Gateway 是否运行:
openclaw gateway status - 检查事件订阅是否配置正确
- 查看日志:
openclaw logs --follow
检查权限列表是否完整导入,特别是 im:message 相关权限。
在配置中添加:
{ "channels": { "feishu": { "groupPolicy": "open", "groups": { "群ID": { "requireMention": false } } } } }
配置完成!现在你可以通过飞书与 OpenClaw AI 助手对话了。
下一步:
- 配置更多 Agent
- 添加自定义技能
- 设置自动化任务
祝你使用愉快!🎉
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/253281.html原文链接:https://javaforall.net
