文章总结： 本文提供Openclaw接入飞书的教程，指出飞书长连接模式比企业微信更适合本地开发，无需公网域名。文章涵盖创建自建应用、配置权限、安装插件及启动网关步骤，并给出本地常驻运行和故障排查建议，助用户实现低成本快速部署。 综合评分： 88 文章分类： 安全工具,安全建设
纯干货、无肥妞：Openclaw接入企微门槛略高，勾搭下飞书还是没啥难度的！
原创
诺多 诺多
高等精灵实验室
2026年2月2日 08:00 江苏
🦞别愣着啦，撸起袖子就是干！
Openclaw
最近关于Clawdbot -> MoltBot -> Openclaw的各类部署教程简直不要太多，多到打开公众号一屏有半屏都是相关的文章，所以我也就没有再水的必要了，反正都是那么回事。
但大家吐槽最多的一点我还是得拎出来说：Openclaw 对接企业微信是真的有点折腾。域名、备案、回调、权限、消息加密、可信IP……一套下来，新手直接晕头转向，稍微配错一个地方，机器人直接装死，查日志都不知道从哪下手。
反观飞书，开放平台清爽、机器人长连接省心、自建应用不用乱七八糟审核，消息收发逻辑直来直去，对个人开发者、小团队、本地玩家极度友好。本地电脑、内网机器、家用主机、云服务器，全都能跑，没有任何硬性门槛，今天就整一篇纯干货、无废话、不抬杠的 Openclaw × 飞书 对接教程，跟着点、跟着填，一次通。
整篇不搞玄学、不搞强制要求，你有啥环境用啥环境，我只讲怎么做、哪里容易错、怎么快速排错。
一、前期准备：啥机器都行，这几样备齐就开干
这里先把话说明白： 没有规定必须云服务器！没有规定必须外网服务器！本地Windows、本地Linux、本地Mac、虚拟机、内网主机、家用NAS、云机，全都能部署。我就是把Openclaw直接跑在Macmini上的。
我只会给建议，不强制：
- • 想24小时在线、随时随地用 → 建议云服务器/轻量云，不关机器不掉线
- • 只想本地测试、自己玩、内网用 → 你自己电脑、虚拟机直接开干，完全没问题
- • 只要机器能正常运行Openclaw、能联网访问飞书开放平台接口，就能对接成功
需要准备的东西就这几样：
- 1. 一套能跑起来的 Openclaw 环境（不管你是Docker、一键脚本、手动编译、Windows版，只要能正常启动、能执行
openclaw命令就行） - 2. 飞书账号（个人版/企业版都行，自建机器人无需企业认证）
- 3. 一个你能用的大模型API Key（通义千问、月之暗面、Kimi、DeepSeek这类都行，Openclaw靠它干活）
- 4. 一台你自己的机器：Windows/macOS/Linux/云服务器
这里友情提示：Openclaw权限较高，本地部署有安全风险，如果你的设备上有重要资料，请仔细掂量好再动手，别到时候被清空了回头来骂我😂，不怕一万就怕万一！
二、先确认：你的Openclaw是正常可用的
不管你在哪部署，先跑一遍基础检查，避免后面对接飞书排错排到怀疑人生。
进入你的Openclaw目录/命令行，执行：
openclaw status
openclaw
只要显示服务正常、模型已配置、无报错，就说明底座没问题。
如果你还没装Openclaw，这里就不重复烂大街的部署流程了，你用你自己习惯的方式装：
- • 一键脚本
curl -fsSL https://openclaw.ai/install.sh | bash
- • Docker-compose
git clone https://github.com/openclaw/openclaw.gitdocker build -t openclaw:local -f Dockerfile .docker compose run --rm openclaw-cli onboarddocker compose up -d openclaw-gateway
哪种方式都行，我不指定、不强推，底座能跑就行。
三、飞书开放平台：创建机器人，3分钟拿凭证
这一步是整个流程最关键的，但也是最简单的，比企微舒服10倍。
-
1. 打开飞书开放平台： https://open.feishu.cn/app
-
2. 登录后，选择 创建企业自建应用 应用名随便填，比如
大龙虾，描述随便写，创建即可。飞书
-
3. 进入应用后台 → 点击 添加应用能力 → 选择 机器人，添加成功。
飞书
-
4. 去到左侧 凭据与基础信息 复制这两个东西，丢记事本存好：
飞书
- • App ID
- • App Secret
这俩就是飞书给你的“通行码”，后面要填进Openclaw。
- 5. 去到左侧 权限管理 这个比较重要，需要添加一些权限才能正常跑起来，具体如下：
- • 必需权限
| 权限 | 范围 | 说明 |
| — | — | — |
| contact:user.base:readonly | 用户信息 | 获取用户基本信息（用于解析发送者姓名，避免群聊/私聊把不同人当成同一说话者） |
| im:message | 消息 | 发送和接收消息 |
| im:message.p2p_msg:readonly | 私聊 | 读取发给机器人的私聊消息 |
| im:message.group_at_msg:readonly | 群聊 | 接收群内@机器人的消息 |
| im:message:send_as_bot | 发送 | 以机器人身份发送消息 |
| im:resource | 媒体 | 上传和下载图片/文件 |
- • 可选权限
| 权限 | 范围 | 说明 |
| — | — | — |
| im:message.group_msg | 群聊 | 读取所有群消息（敏感） |
| im:message:readonly | 读取 | 获取历史消息 |
| im:message:update | 编辑 | 更新/编辑已发送消息 |
| im:message:recall | 撤回 | 撤回已发送消息 |
| im:message.reactions:read | 表情 | 查看消息表情回复 |
- • 飞书文档权限（也是按需选择）
| 权限 | 说明 |
| — | — |
| docx:document | 创建/编辑文档 |
| docx:document:readonly | 读取文档 |
| docx:document.block:convert | Markdown 转 blocks（write/append 必需） |
| drive:drive | 上传图片到文档 |
| drive:drive:readonly | 列出文件夹 |
-
6. 最后，发布这个应用 飞书的应用，每次修改后都要发布版本才能生效，这个不要忘了！
飞书
四、Openclaw 配置飞书通道：把机器人接进来
不管你是本地机器、内网、服务器，操作完全一样。
- • 首先安装插件：
openclaw plugins install @m1heng-clawd/feishu
- • 然后配置飞书参数：
openclaw config set channels.feishu.appId "你的appId"
openclaw config set channels.feishu.appSecret "你的appSecret"
openclaw config set channels.feishu.enabled true
配置成功后，Openclaw就已经识别飞书机器人通道了。
- • 接下来启动网关，让Openclaw监听飞书消息：
openclaw gateway restart
不用映射外网、不用域名、不用备案！ 飞书机器人走长连接，不是传统Webhook回调，这就是它对本地玩家最友好的地方。
提醒
这地方有个坑要提前说一下，如果上面重启网关失败，比如报下面的错误：
openclaw gateway restart
13:46:10 [plugins] feishu failed to load from /Users/xxx/.openclaw/extensions/feishu/index.ts: Error: Cannot find module '@larksuiteoapi/node-sdk'
这是因为安装插件过程中没有正常安装完依赖导致的，只需要到插件目录继续安装下就行：
cd ~/.openclaw/extensions/feishu
npm install
五、飞书后台补权限与事件：不配置收不到消息
这一步很多人漏，导致机器人“已上线但不回话”，跟着点就行。
回到飞书开放平台你的应用后台：
1. 配置事件与回调
左侧进入 事件与回调
- • 事件配置中，订阅方式选择 长连接，保存
飞书
- • 继续点击下面的 添加事件 ，添加下面的事件
| 事件 | 说明 |
| — | — |
| im.message.receive_v1 | 接收消息（必需） |
| im.message.message_read_v1 | 消息已读回执 |
| im.chat.member.bot.added_v1 | 机器人进群 |
| im.chat.member.bot.deleted_v1 | 机器人被移出群 |
飞书
-
•
-
• 回调配置中，订阅方式页选择 长连接，保存
飞书
长连接模式下，不需要填公网URL、不需要域名、不需要穿透，本地直接能通，这就是飞书比企微爽的核心原因。
2. 发布版本
右上角点击 创建版本并发布 个人使用、内部测试，直接发布即可，无需审核、无需等待。
发布后，在飞书客户端搜索你的机器人名称，就能找到它。
六、测试对话：本地/服务器都能直接用
打开飞书，找到你刚创建的机器人，直接发消息：
- • 你好
- • 帮我写个工作总结
- • 解释一下什么是Openclaw
- • 教我怎么在macmini上部署openclaw，并且设置飞书channel
Openclaw
只要Openclaw网关在运行，模型配置正常，飞书机器人会秒回/慢回🤣。
- • 本地运行的同学，只要你电脑不关、网关进程不挂，机器人就一直在线。
- • 云服务器运行的同学，就是24小时在线，随时随地用。
七、本地玩家必看：让网关后台常驻（不关终端也能跑）
如果你是本地Windows/macOS/Linux，不想一直开着命令行窗口，可以用后台挂起。
Linux/macOS 后台常驻
nohup openclaw gateway --port 18789 > openclaw.log 2>&1 &
Windows 可以用：
- • start 后台启动
- • 或者写个bat脚本最小化运行
- • 也可以用PM2托管（装个node就行）
八、新手最容易踩的坑（无恐吓，纯提醒）
- 1. 飞书权限没开全 → 机器人收到消息但不回复，多半是权限
- 2. AppID/AppSecret 复制多了空格 → 长连接连不上，仔细检查
- 3. Openclaw模型没配置 → 通道正常，但AI不回答，先测
openclaw chat - 4. 本地网关关了 → 机器人断连，重新启动网关即可
宝子们，如果你觉得这篇文章有用，记得给我点个赞，分享给更多小伙伴哦！下期想看什么，评论区告诉我！💖
高等精灵实验室
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：高等精灵实验室 诺多 诺多《纯干货、无肥妞：Openclaw接入企微门槛略高，勾搭下飞书还是没啥难度的！》
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论