OpenClaw接入飞书全流程:让AI在飞书群里帮你干活装完OpenClaw之后,很多朋友问:能不能不开网页,直接在飞书上指挥它?答案是可以。今天胖豆手把手教你把OpenClaw接入飞书,实现在聊天窗口里直接让AI帮你干活。
为什么要接入飞书?
上几篇教程里,我们一直通过浏览器打开 http://127.0.0.1:18789 的WebChat来跟OpenClaw对话。能用,但不够方便——你得专门开个浏览器窗口,来回切换。你在飞书里直接@机器人,它就帮你干活。跟同事聊天的间隙,顺手让AI帮你处理个文件、查个数据、写段代码,无缝衔接。而且飞书是国内OpenClaw用户最主流的选择——中文界面、文档齐全、开放能力强,比Telegram和Discord对国内用户友好太多了。飞书甚至推出了OpenClaw官方插件,说明官方也在认真推这个生态。
前置条件
✅ 你已经按照第三篇教程成功安装了OpenClaw✅ OpenClaw的Gateway服务正在运行(openclaw gateway status 能看到状态)如果OpenClaw还没装好,先去翻我的第三篇文章《Windows部署OpenClaw保姆级教程》。
整体流程预览
飞书接入一共分5大步,先给你一个全景图,心里有数:看起来步骤多,但跟着走其实就是"飞书点点点 → 终端敲几行命令 → 飞书再点点点"的节奏。大概20-30分钟能搞定。
第一步:在飞书开放平台创建应用
💡 胖豆提示: 飞书免费版就能创建自建应用,不需要付费。
第二步:获取App ID和App Secret
⚠️ 安全提醒: App Secret相当于你应用的密码,不要分享给任何人,不要贴到公开的地方。
第三步:在OpenClaw中配置飞书通道
回到你的电脑,打开PowerShell,执行以下命令配置飞书:启用飞书通道
openclaw configsetchannels.feishu.enabled true
填入你的App ID(替换成你自己的)
openclaw configsetchannels.feishu.accounts.main.appId"cli_你的AppID"
填入你的App Secret(替换成你自己的)
openclaw configsetchannels.feishu.accounts.main.appSecret"你的AppSecret"
设置机器人名称
openclaw configsetchannels.feishu.accounts.main.botName"我的AI助手"
使用WebSocket长连接模式(推荐,不需要公网IP)
openclaw configsetchannels.feishu.connectionMode websocket
设置私聊策略为配对模式
openclaw configsetchannels.feishu.dmPolicy pairing
设置群聊需要@才回复
openclaw configsetchannels.feishu.requireMention true
openclaw gateway restart
💡 胖豆踩坑笔记: 如果你之前安装过旧版的第三方飞书插件,建议先卸载干净再配置。新版OpenClaw已经内置了官方飞书支持,不需要额外装插件了。如果是老版本,可能需要执行 openclaw plugins install @openclaw/feishu 来安装飞书插件。
第四步:回到飞书配置权限和事件
这一步回到飞书开放平台的应用管理界面,需要配置三样东西。左侧菜单 →「应用能力」→ 找到「机器人」→ 点击「添加」[
"im:message",
"im:message.group_at_msg",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource",
"contact:user.id:readonly"
]
这些权限让机器人能收发消息、读取被@的内容、发送回复。💡 胖豆提示: 如果你希望机器人能做更多事情(比如读写文档、管理日历),可以后续在权限管理里按需添加更多权限。先把基础的跑通再说。
订阅方式选择:「使用长连接接收事件(WebSocket)」然后添加事件:搜索并添加 im.message.receive_v1(接收消息事件)
第五步:发布应用并测试
左侧菜单 →「版本管理与发布」→ 点击「创建版本」如果是个人飞书(不是企业),发布后直接就能用。如果是企业飞书,可能需要管理员审批。打开飞书客户端,找到你刚才创建的机器人(在应用列表或搜索栏搜名字)。第一次对话时,机器人可能会回复一个配对码。这是OpenClaw的安全机制,需要你确认授权。回到OpenClaw的WebChat界面(http://127.0.0.1:18789),在里面输入配对码完成确认。这是一次性操作,后面就不需要了。
接入成功后能做什么?
在飞书里跟同事聊完工作,顺手切到机器人窗口:"帮我把今天讨论的3个待办事项整理成清单"。在工作群里@机器人:"帮我总结一下刚才大家讨论的核心结论"(需要给机器人加入群聊的权限)。飞书有手机端,接入之后你在手机上也能跟OpenClaw对话。躺在沙发上用手机指挥电脑上的AI干活,这感觉绝了。配合OpenClaw的cron功能,让机器人每天早上在飞书给你发一份今日待办和天气预报。
常见问题排查
OpenClaw的Gateway是否在运行?执行 openclaw gateway status 确认查看日志:openclaw logs --follow,看有没有报错确认已添加 im.message.receive_v1 事件订阅回到飞书开放平台 → 权限管理,检查是否缺少必要权限。添加权限后需要重新发布版本才能生效。OpenClaw配置中 requireMention 是否设为 true(设为true则必须@才会回复)打开浏览器访问 http://127.0.0.1:18789,在WebChat里告诉OpenClaw配对码即可。你也可以直接执行命令:openclaw devices approve <配对码>
安全注意事项(认真看)
飞书接入之后,机器人是以你的身份在运作的。这意味着:① 它发的消息就是"你发的"。AI代你在飞书里发的消息,对方看到的发送者就是你。发出去就收不回来了。所以涉及重要沟通的操作,务必先预览再确认,不要让AI全自动运行。② 先用个人账号玩,别急着上公司账号。等你熟悉了OpenClaw的行为模式,确认它不会乱发消息之后,再考虑接入工作环境。③ 定期检查权限范围。不需要的权限不要给。机器人能读到的信息越少,风险越小。
完整流程回顾
✅ 飞书侧添加机器人能力 + 导入权限 + 事件订阅整个过程大约20-30分钟。一旦配好,以后就是打开飞书直接聊的事了。
下篇预告
OpenClaw系列到这里告一段落。我们已经完成了:认识它→安装它→体验它→接入飞书。你的私人AI助手已经就位了。下一篇我们换个话题,聊一个很多人都在想但不好意思问的问题——结合VibeCoding的爆发、Spotify工程师不再写代码的新闻,以及我自己作为程序员的真实感受,跟你聊聊AI对我们这行的真实影响。不贩卖焦虑,只说真话。