# 【小白教程】OpenClaw 飞书极速接入指南 - (防坑纯血教学版)

📅 发布时间:2026/7/10 22:20:48 👁️ 浏览次数:
# 【小白教程】OpenClaw 飞书极速接入指南 - (防坑纯血教学版)
前言各位看官好上一篇教程咱们把模型换成了聪明的 Claude。今天这篇老X 手把手教你把 OpenClaw 接入飞书相比 Telegram飞书在国内不需要科学上网更适合当本土的极速 AI 助理。⚠️注意飞书接入有两个大坑一个是配置事件订阅前的死循环要求另一个是致命的前缀陷阱。这篇教程已经帮大伙把坑全填平了只要跟着图片操作绝对一遍过阶段一在飞书开放平台打造躯壳首先我们需要在飞书后台创建一个机器人应用。1. 登录并创建应用浏览器访问 飞书开放平台。点击右上的「开发者后台」然后「创建应用」→「企业自建应用」。填好名称比如于大爷助理和简介点击创建。然后在左侧「应用能力」里给它添加「机器人」能力。2. ⭐ 第一防坑点获取带前缀的 App ID在左侧点击「凭证与基础信息」。你会看到你需要的重要凭证。⚠️这是新手死得最多的地方App ID 必须是完整包含cli_开头的全串很多小白复制时漏掉cli_会导致后续所有连接瞬间暴毙报 400 错误请把图中框出的App ID和App Secret完整复制保存到你的记事本里备用。阶段二给机器人开天眼权限配置机器人想要看懂消息并回复必须开通权限。开通核心权限点击左侧「权限管理」在搜索框分别搜索以下三个权限并点击「开通」im:messageim:message.group_at_msgim:message.p2p_msg⚠️看图这三个权限一个都不能少少一个机器人就变成了哑巴阶段三本地启动连接桥梁在去网页上点事件订阅之前必须先在本地电脑上跑起你的 OpenClaw否则飞书不让你保存。1. 配置 OpenClaw 向导打开电脑的PowerShell 终端输入以下命令cdD:\Openclaw\openclaw npx openclaw configure--channelfeishu照着下面的图填入刚才记事本里的 App ID 和 App Secret模式选 WebSocket策略建议选 Allowlist。2. 启动服务连入飞书配置填完后紧接着在终端里敲回车启动npx openclaw gateway start只要黑框里刷出了绿色的ws client ready说明底层 WebSocket 握手成功此时终端千万别关让它开着阶段四网页端打通任督二脉回到刚才的飞书网页里。1. 配置长连接与订阅事件点击左侧「事件与回调」→「事件配置」。因为你本地的黑框正开着红色的未检测到应用连接信息错误不会再出现了选择「使用长连接接收事件」然后在下方已添加事件里添加im.message.receive_v1接收消息。2. 必须要做的全员发布飞书有强制的发布机制。你在上面改的所有权限和事件必须在**「版本管理与发布」里点一下发布**才生效。点击左侧的「版本管理与发布」点「创建版本」随便写个版本号拉到最底下点「保存并发布」就行。阶段五认主仪式配对授权最后一步让它认你做主人打开飞书客户端搜索机器人的名字并进入私聊。给它发一句“你好”。由于安全机制它不会马上理你而是会回复一段带有一段代码和验证码的话。看到图里它给你的那串代码了吧在电脑上再新开一个 PowerShell 黑框原封不动贴进去执行它cdD:\Openclaw\openclaw npx openclaw pairing approve feishu 你的那串验证码恭喜你的专属飞书 AI 助理配置大功告成只要保证电脑上那个gateway start黑框一直开着随时都能在手机里调戏它常见故障排查报 400 错误检查你的 App ID是不是漏了最前面的cli_事件订阅无法保存说明你本地电脑的npx openclaw gateway start没运行赶紧运行起来再去网页上点保存。参考资源本地部署看这篇OpenClaw 极速本地部署指南模型调优看这篇OpenClaw 模型配置终极指南作者AI极客老X发布时间2026年3月7日原创声明本文为原创教程转载请注明出处。