夜雨聆风点击蓝字，关注我们
从此告别守着电脑干活，飞书里@一下，你的“龙虾”随叫随到
继上篇OpenClaw进阶工作流进阶篇：让“龙虾”真正替你干活——20条可复制的自动化工作流，后台又炸了：
“工作流是牛，但我总不能一直守在电脑前吧？”
“出门在外想让它干活，还得远程桌面，太麻烦了”
“能不能像ChatGPT那样，在飞书里直接跟它聊天？”
今天就手把手教你：把OpenClaw接入飞书，让它变成你24小时在线的飞书机器人。 以后无论是在地铁上、咖啡馆里，还是躺在床上，只要打开飞书@一下，你的“龙虾”随叫随到。
1
为什么要把OpenClaw接入飞书？
先想一个场景：
你正在外面开会，突然想起来今天要监控的行业数据还没跑。按以前的操作：找电脑→远程桌面→打开OpenClaw→敲命令→等结果。一套下来，会都开完了。
接入飞书之后呢？
打开飞书，在群里@机器人：“帮我跑一下今天的行业数据监控”，五分钟后再看，结果已经发在群里了。
这就是区别：把OpenClaw从“本地员工”变成“云员工”，从“守在电脑前”变成“随时随地”。
飞书接入的核心优势：
· ✅ 随时随地：有网就能指挥你的AI干活
· ✅ 群聊协作：可以把机器人拉进群，团队一起用
· ✅ 消息即指令：自然语言对话，不用记命令
· ✅ 文件直接传：PDF、图片直接丢给机器人处理
2
准备工作：你需要什么？
开始之前，先检查一下这几样东西准备好了没：
硬件/软件清单
· ✅ 已部署好的OpenClaw（本地或云端都行，版本建议2026.2.9以上）
· ✅ OpenClaw服务正常运行（openclaw status确认一下）
· ✅ 飞书企业账号（个人飞书不行，必须是企业版）
· ✅ 管理员权限（创建自建应用需要开发者权限，可以找公司IT开通）
需要记下来的信息
· OpenClaw服务器的IP或本地地址
· OpenClaw的访问凭证（如有）
· 飞书账号（用于登录开放平台）
小提示：如果你还没部署OpenClaw，可以先翻翻我们之前的《手把手教你“养龙虾”》文章手把手教你“养龙虾”：OpenClaw本地部署完全指南（Windows/Mac/Linux全兼容），先把“龙虾”养起来再来接飞书。
3
第一步：创建飞书应用（养个“飞书壳”）
3.1 登录飞书开放平台
打开浏览器，访问 飞书开放平台，用你的飞书企业账号登录。
3.2 创建企业自建应用
点击右上角的“开发者后台”，进入后找到“创建企业自建应用”。
填写应用信息：
· 应用名称：比如“OpenClaw小助手”或“我的AI龙虾”（随便起，自己喜欢就好）
· 应用描述：简单说明一下用途，比如“24小时AI智能体，帮你干活”
· 应用图标：可以随便选一个，后面也能改
填完后点击“创建”。
3.3 添加机器人能力
创建成功后进入应用详情页，左侧导航栏找到“添加应用能力”，点击后选择“机器人”，然后点击“添加”。
这一步是告诉飞书：我这个应用是个机器人，能跟人聊天。
3.4 记录核心凭证（最重要的一步！）
左侧导航栏找到“凭证与基础信息”，你会看到两个非常重要的字符串：
· App ID：格式像 cli_xxxxxxxxx，应用的身份证号
· App Secret：一串密文，相当于应用的密码
⚠️ 重要提醒：这两串信息请立刻复制保存到安全的地方（比如记事本或密码管理器）。App Secret关闭页面后就看不到了，如果丢了只能重置。
3.5 配置权限（让机器人能说话）
左侧导航栏找到“权限管理”，我们需要给机器人开通聊天的权限。
有两种方式：
方式一（推荐）：点击“批量导入/导出权限”，粘贴下面这段JSON配置：
json
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
方式二：手动搜索并开通以下核心权限：
· im:message - 收发消息
· im:message.p2p_msg:readonly - 读取私聊消息
· im:message.group_at_msg:readonly - 接收群聊@消息
· im:message:send_as_bot - 以机器人身份发送消息
· im:resource - 上传/下载图片文件
点击“确认开通”，搞定。
4
第二步：配置OpenClaw（让“龙虾”认识飞书）
4.1 安装飞书插件（如果还没装）
打开你的OpenClaw终端（SSH到服务器或打开本地命令行），执行：
bash
openclaw plugins install @openclaw/feishu
看到安装成功提示就行。
注意：有些新版镜像可能已经预装了飞书插件，可以用openclaw plugins list先查一下。
4.2 配置飞书凭证
现在要把刚才保存的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
4.3 重启OpenClaw网关
配置完必须重启，让配置生效：
bash
openclaw gateway restart
4.4 验证配置是否成功
执行：
bash
openclaw status
如果看到类似这样的输出，说明飞书通道已经打开：
│ Feishu │ ON │ OK │ configured │
5
第三步：配置飞书事件订阅（打通任督二脉）
5.1 选择长连接模式
回到飞书开放平台你的应用后台，左侧导航栏找到“事件与回调”。
在“事件配置”页签，找到“订阅方式”，选择 “使用长连接接收事件”，然后点击“保存”。
⚠️ 重要提醒：这一步必须在配置完App ID/Secret并重启OpenClaw之后才能成功。如果保存时报错“未建立长连接”，说明OpenClaw那边还没配置好或网关没重启，检查一下再试。
5.2 添加接收消息事件
保存成功后，在同一页面点击“添加事件”。
在弹出的搜索框里输入“接收消息”，找到 im.message.receive_v1，选中后点击“确认添加”。
这一步告诉飞书：当有人给机器人发消息时，要通知OpenClaw来处理。
5.3 回调配置（可选）
切换到“回调配置”页签，同样选择“使用长连接接收回调”，点击保存即可。这一步不是必须的，但建议配一下，让机器人功能更完整。
6
第四步：发布应用（让机器人上线）
6.1 创建版本
左侧导航栏找到“版本管理与发布”，点击“创建版本”。
填写：
· 版本号：比如 1.0.0（按规范写，如v1.0.0）
· 更新说明：比如“首次发布，支持OpenClaw飞书对话”
填好后点击“保存”。
6.2 确认发布
保存后会出现确认弹窗，点击“确认发布”，然后等待审批。
如果你是企业的管理员，可以自己审批通过；如果不是，需要联系管理员帮忙审批一下。
7
第五步：开始使用（@你的AI员工）
7.1 添加机器人到聊天
单聊：在飞书通讯录里搜索你的应用名称（比如“OpenClaw小助手”），点进去就可以直接聊天。
群聊：在群聊设置里找到“群机器人”→“添加机器人”，搜索你的应用名称添加即可。
7.2 第一次对话：可能会需要配对
有些版本在第一次对话时，机器人会回复一个“配对码”，类似这样：
请执行以下命令完成配对：
openclaw pairing approve feishu 123456
这时候你需要回到OpenClaw的终端，执行这个命令，配对成功后就能正常聊天了。
7.3 正常使用
配对完成后，你就可以像跟朋友聊天一样@你的机器人了：
· 单聊：直接发消息
· 群聊：记得要@机器人（除非你配置了免@模式）
试试问它：“帮我总结一下今天的行业热点”、“给团队写一份周报模板”……你的“龙虾”会在飞书里乖乖干活。
8
避坑指南（新手最容易踩的坑）
坑1：收不到消息
症状：给机器人发消息，完全没反应
检查清单：
· ✅ 应用已发布（不是草稿状态）
· ✅ 事件订阅用的是“长连接”，不是Webhook
· ✅ 三个im权限都开了（im:message、群聊@、私聊）
· ✅ OpenClaw网关已重启（openclaw gateway restart）
坑2：长连接配置报错
症状：在飞书后台保存事件订阅时报“未建立长连接”
原因：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里。
点赞
收藏
分享
你的OpenClaw接入飞书成功了吗？来评论区晒出你的机器人对话截图吧！ 🦞💬
