先想一个场景:
你正在外面开会,突然想起来今天要监控的行业数据还没跑。按以前的操作:找电脑→远程桌面→打开OpenClaw→敲命令→等结果。一套下来,会都开完了。
接入飞书之后呢?
打开飞书,在群里@机器人:“帮我跑一下今天的行业数据监控”,五分钟后再看,结果已经发在群里了。
这就是区别:把OpenClaw从“本地员工”变成“云员工”,从“守在电脑前”变成“随时随地”。
飞书接入的核心优势:
· ✅ 随时随地:有网就能指挥你的AI干活
· ✅ 群聊协作:可以把机器人拉进群,团队一起用
· ✅ 消息即指令:自然语言对话,不用记命令
· ✅ 文件直接传:PDF、图片直接丢给机器人处理
开始之前,先检查一下这几样东西准备好了没:
硬件/软件清单
· ✅ 已部署好的OpenClaw(本地或云端都行,版本建议2026.2.9以上)
· ✅ OpenClaw服务正常运行(openclaw status确认一下)
· ✅ 飞书企业账号(个人飞书不行,必须是企业版)
· ✅ 管理员权限(创建自建应用需要开发者权限,可以找公司IT开通)
需要记下来的信息
· OpenClaw服务器的IP或本地地址
· OpenClaw的访问凭证(如有)
· 飞书账号(用于登录开放平台)
打开浏览器,访问 飞书开放平台,用你的飞书企业账号登录。
点击右上角的“开发者后台”,进入后找到“创建企业自建应用”。
填写应用信息:
· 应用名称:比如“OpenClaw小助手”或“我的AI龙虾”(随便起,自己喜欢就好)
· 应用描述:简单说明一下用途,比如“24小时AI智能体,帮你干活”
· 应用图标:可以随便选一个,后面也能改
填完后点击“创建”。
创建成功后进入应用详情页,左侧导航栏找到“添加应用能力”,点击后选择“机器人”,然后点击“添加”。
这一步是告诉飞书:我这个应用是个机器人,能跟人聊天。
左侧导航栏找到“凭证与基础信息”,你会看到两个非常重要的字符串:
· App ID:格式像 cli_xxxxxxxxx,应用的身份证号
· App Secret:一串密文,相当于应用的密码
⚠️ 重要提醒:这两串信息请立刻复制保存到安全的地方(比如记事本或密码管理器)。App Secret关闭页面后就看不到了,如果丢了只能重置。
左侧导航栏找到“权限管理”,我们需要给机器人开通聊天的权限。
有两种方式:
方式一(推荐):点击“批量导入/导出权限”,粘贴下面这段JSON配置:
json }
方式二:手动搜索并开通以下核心权限:
· im:message - 收发消息
· im:message.p2p_msg:readonly - 读取私聊消息
· im:message.group_at_msg:readonly - 接收群聊@消息
· im:message:send_as_bot - 以机器人身份发送消息
· im:resource - 上传/下载图片文件
点击“确认开通”,搞定。
打开你的OpenClaw终端(SSH到服务器或打开本地命令行),执行:
bash openclaw plugins install @openclaw/feishu
看到安装成功提示就行。
注意:有些新版镜像可能已经预装了飞书插件,可以用openclaw plugins list先查一下。
现在要把刚才保存的App ID和App Secret告诉OpenClaw。
执行命令(记得替换成你自己的值):
bash openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.appId "cli_你的AppID" openclaw config set channels.feishu.appSecret "你的AppSecret"
如果想用WebSocket长连接(推荐,无需公网IP),再加一条:
bash openclaw config set channels.feishu.connectionMode websocket
配置完必须重启,让配置生效:
bash openclaw gateway restart
执行:
bash openclaw status
如果看到类似这样的输出,说明飞书通道已经打开:
│ Feishu │ ON │ OK │ configured │
回到飞书开放平台你的应用后台,左侧导航栏找到“事件与回调”。
在“事件配置”页签,找到“订阅方式”,选择 “使用长连接接收事件”,然后点击“保存”。
⚠️ 重要提醒:这一步必须在配置完App ID/Secret并重启OpenClaw之后才能成功。如果保存时报错“未建立长连接”,说明OpenClaw那边还没配置好或网关没重启,检查一下再试。
保存成功后,在同一页面点击“添加事件”。
在弹出的搜索框里输入“接收消息”,找到 im.message.receive_v1,选中后点击“确认添加”。
这一步告诉飞书:当有人给机器人发消息时,要通知OpenClaw来处理。
切换到“回调配置”页签,同样选择“使用长连接接收回调”,点击保存即可。这一步不是必须的,但建议配一下,让机器人功能更完整。
左侧导航栏找到“版本管理与发布”,点击“创建版本”。
填写:
· 版本号:比如 1.0.0(按规范写,如v1.0.0)
· 更新说明:比如“首次发布,支持OpenClaw飞书对话”
填好后点击“保存”。
保存后会出现确认弹窗,点击“确认发布”,然后等待审批。
如果你是企业的管理员,可以自己审批通过;如果不是,需要联系管理员帮忙审批一下。
单聊:在飞书通讯录里搜索你的应用名称(比如“OpenClaw小助手”),点进去就可以直接聊天。
群聊:在群聊设置里找到“群机器人”→“添加机器人”,搜索你的应用名称添加即可。
有些版本在第一次对话时,机器人会回复一个“配对码”,类似这样:
请执行以下命令完成配对:
openclaw pairing approve feishu
这时候你需要回到OpenClaw的终端,执行这个命令,配对成功后就能正常聊天了。
配对完成后,你就可以像跟朋友聊天一样@你的机器人了:
· 单聊:直接发消息
· 群聊:记得要@机器人(除非你配置了免@模式)
试试问它:“帮我总结一下今天的行业热点”、“给团队写一份周报模板”……你的“龙虾”会在飞书里乖乖干活。
症状:给机器人发消息,完全没反应
检查清单:
· ✅ 应用已发布(不是草稿状态)
· ✅ 事件订阅用的是“长连接”,不是Webhook
· ✅ 三个im权限都开了(im:message、群聊@、私聊)
· ✅ OpenClaw网关已重启(openclaw gateway restart)
症状:在飞书后台保存事件订阅时报“未建立长连接”
原因:OpenClaw那边还没配置好App ID/Secret,或者网关没重启
解决:
1. 确认openclaw config set命令执行成功
2. 执行openclaw gateway restart重启
3. 等10秒左右,再回飞书后台保存
坑3:群聊不回复
症状:群里@机器人,它不理人
原因:默认配置需要@才回复,但可能@格式不对
解决:
· 确认是真的@了机器人(名字变蓝)
· 或者在消息末尾加个问号(部分版本支持)
· 如果想让它更主动,可以修改配置requireMention为false
坑4:App Secret丢了
症状:忘了保存App Secret,关掉页面找不到了
解决:在飞书开放平台的应用后台,进入“凭证与基础信息”,点击App Secret旁边的“重置”,生成一个新的。记得重新配置到OpenClaw里。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/248307.html