🎯 OpenClaw 配置飞书(Feishu)完整教程

🎯 OpenClaw 配置飞书(Feishu)完整教程

本文将详细介绍如何在 OpenClaw 中配置飞书(Feishu/Lark)插件,让你的 AI 助手能够通过飞书与用户进行交互。

前置条件:

  • ✅ 已安装 OpenClaw
  • ✅ 有飞书/ Lark 企业账号
  • ✅ 电脑能访问飞书开放平台

打开终端,运行以下命令:

openclaw plugins install @openclaw/feishu

或本地开发版本:

openclaw plugins install ./extensions/feishu

打开浏览器,访问:开发者后台 – 飞书开放平台

登录你的飞书账号。

⚠️ 如果你使用的是 Lark 国际版,请访问:Lark 开放平台

  1. 点击 「创建企业自建应用」
  2. 填写应用名称(如:OpenClaw 助手)openclaw skills 教程
  3. 上传应用图标(可选)
  4. 点击创建

创建成功后,在应用页面找到 「凭证与基础信息」,复制:

  • 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」

  1. 开启 「Bot 能力」
  2. 设置 Bot 名称(如:OpenClaw 助手)
  3. 添加 Bot 头像(可选)

⚠️ 这一步需要先运行 OpenClaw 配置,请先完成第六步的前半部分,再回来继续。

在应用页面,点击 「事件与回调」

  1. 选择 「使用长连接接收事件」(WebSocket)
  2. 点击添加事件

添加以下事件:

  • im.message.receive_v1 – 接收消息

点击确定保存。


运行配置向导:

openclaw onboard

按照提示:

  1. 选择添加飞书频道
  2. 输入 App ID 和 App Secret
  3. 启动 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. 点击 「创建新版本」
  2. 填写版本号(如:1.0.0)
  3. 填写更新说明
  4. 提交审核

审核通过后(企业应用通常自动通过),点击 「直接发布」


openclaw gateway status

确保 Gateway 已启动。

在飞书中搜索你的 Bot 名称,发送一条消息。

如果开启了配对模式,需要批准配对:

openclaw pairing approve feishu <配对码>

配对成功后,就可以开始对话了!


  1. 检查 Gateway 是否运行:openclaw gateway status
  2. 检查事件订阅是否配置正确
  3. 查看日志:openclaw logs --follow

检查权限列表是否完整导入,特别是 im:message 相关权限。

在配置中添加:

{ "channels": { "feishu": { "groupPolicy": "open", "groups": { "群ID": { "requireMention": false } } } } }

配置完成!现在你可以通过飞书与 OpenClaw AI 助手对话了。

下一步:

  • 配置更多 Agent
  • 添加自定义技能
  • 设置自动化任务

祝你使用愉快!🎉

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/253281.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午3:57
下一篇 2026年3月13日 下午3:57


相关推荐

关注全栈程序员社区公众号