夜雨聆风篇号：OpenClaw完全指南 第6篇（共8篇）
开头
说实话，你有没有过这样的时刻？
你正在外面出差，突然想起来电脑桌面上堆满了乱七八糟的文件，想整理一下。但电脑在家里，你又不想专门跑回去。或者你正躺在沙发上刷手机，突然有个想法需要电脑处理，但就是懒得起身去开电脑。
如果这时候，你只需要在手机上发一句话，家里的电脑就能自动帮你干活，5分钟后告诉你"搞定了"，那该多好？
这不是科幻电影，这就是OpenClaw接入飞书之后能做的事。
想象一下这个场景：你在酒店用手机打开飞书，给你的AI助手发一句"帮我整理一下桌面上的文件，把图片放到图片文件夹，文档放到文档文件夹"。几分钟后，手机震动，AI助手回复："桌面已整理完毕，共移动23个文件。"
或者你正在开会，突然需要查一个数据，你给AI助手发一句"查一下上个月的销售额，做成表格发给我"。会议还没结束，表格已经发到了你的飞书上。
这就是为什么我说，这篇是整个系列里最实用的一篇。因为接入飞书后，OpenClaw就不再只是你电脑上的一个工具，而是变成了你的数字管家，随时随地听候差遣。
为什么选择飞书？说实话，因为它是国内最好用的协作工具，没有之一。更重要的是，OpenClaw对飞书的支持是最完整的，从消息收发到权限管理，一应俱全。而且整个过程不需要你有公网IP，用长连接模式就能搞定，对普通用户特别友好。
一、整体思路
在开始具体操作之前，我先给你捋清楚整个接入的逻辑。其实就两件事：
第一件事，在飞书开放平台创建一个"机器人"。你可以把这个机器人理解成你的AI助手在飞书里的账号。有了这个账号，别人才能在飞书里找到它、给它发消息。
第二件事，把这个机器人和你本地的OpenClaw连起来。这样当有人给飞书里的机器人发消息时，消息就能传到你的电脑上，OpenClaw处理完之后，再把回复传回飞书。
整个过程最妙的地方是，你不需要公网IP，也不需要复杂的网络配置。OpenClaw用的是长连接模式（WebSocket），你的电脑主动去连接飞书的服务器，建立一条稳定的通信通道。
这就好比你的电脑主动给飞书服务器打了个电话："嗨，我在这儿，有消息就通过这条线告诉我。"然后这条电话线就一直保持着，随时可以通话。
二、在飞书开放平台创建应用
好了，理论讲完，咱们开始实操。这部分稍微有点步骤，但别怕，我一步一步带你走。
第1步：打开飞书开放平台
用浏览器打开 https://open.feishu.cn/app，用你的飞书账号登录。如果你还没有飞书账号，先去注册一个，免费的。
第2步：创建企业自建应用
登录后，点击页面上的"创建企业自建应用"。这里有个小提示：虽然叫"企业自建"，但个人用户完全可以用，不用担心。
应用名称随便起，比如"我的AI助手"、"OpenClaw管家"之类的，好记就行。描述可以写"个人AI助手"，然后点击创建。
第3步：记下App ID和App Secret
应用创建成功后，进入应用管理页面。在左侧菜单找到"凭证与基础信息"，点进去。
这里你会看到两个关键信息：App ID和App Secret。这两个就像是你机器人的身份证和密码，非常重要。
把这两个值复制下来，找个安全的地方保存好。特别是App Secret，它只显示一次，如果你忘了，就只能去重置了。
第4步：申请权限
还是在应用管理页面，找到"权限管理"。我们需要给机器人申请几个必要的权限：
- ▶
im:message：接收消息的权限 - ▶
im:chat：获取聊天信息的权限 - ▶
im:message:send_as_bot：以机器人身份发送消息的权限
点击每个权限后面的"申请权限"，然后提交。这些权限审核很快，一般几分钟就能通过。
第5步：启用机器人
在左侧菜单找到"应用能力"，点击"机器人"，然后点击"启用机器人"。这个步骤很简单，就是点一下开关。
第6步：配置事件订阅
这是最关键的一步。在左侧菜单找到"事件订阅"，点进去。
首先，在"请求地址配置"那里，选择"使用长连接接收事件"。这个选项很重要，选错了机器人就收不到消息。
然后，在"事件订阅"部分，点击"添加事件"，找到并添加im.message.receive_v1这个事件。这个事件的意思是"当机器人收到消息时通知我"。
第7步：发布应用
最后一步，在左侧菜单找到"版本管理与发布"，点击"创建版本"，填写版本号（比如1.0.0），然后点击"保存"。
保存后，点击"申请发布"。飞书会审核你的应用，一般几分钟就能通过。审核通过后，你的机器人就正式上线了。
到这里，飞书平台上的配置就全部完成了。是不是比想象中简单？
三、在OpenClaw中配置飞书
飞书那边搞定了，现在回到你的电脑，配置OpenClaw。
首先，启动网关
在配置之前，必须先确保OpenClaw的网关在运行。打开终端，输入：
如果网关已经在运行，你会看到相关的日志输出。如果没运行，这个命令会启动它。
方式一：使用向导配置（推荐）
这是最简单的方式。在终端输入：
然后按照向导的提示，一步步填写：
- ▶选择飞书（feishu）
- ▶输入刚才记下的App ID
- ▶输入App Secret
- ▶其他选项保持默认
向导会自动帮你生成配置文件，并重启网关。
方式二：手动编辑配置文件
如果你喜欢手动操作，可以直接编辑配置文件。配置文件在~/.openclaw/openclaw.json。
用文本编辑器打开这个文件，找到channels部分，添加飞书的配置：
"channels": {
"feishu": {
"appId": "你的App ID",
"appSecret": "你的App Secret",
"dmPolicy": "allowlist",
"enabled": true
}
}
}
把你的App ID和你的App Secret替换成实际的值。dmPolicy设置为allowlist的意思是只允许白名单用户使用，这个我们后面会详细讲。
保存文件后，需要重启网关让配置生效：
配置完成检查
无论用哪种方式，配置完成后，检查网关的日志。如果看到类似这样的信息，就说明配置成功了：
[info] Waiting for pairing requests...
四、验证：发送第一条消息
最激动人心的时刻来了——测试你的机器人是否真的能用了。
第一步：找到你的机器人
在飞书App里，点击右上角的搜索图标，输入你给机器人起的名字（就是创建应用时填的名称）。
找到你的机器人，点击进入聊天界面。
第二步：发送第一条消息
在聊天框里输入"你好"，然后发送。
等待几秒钟，如果你的配置一切正确，机器人应该会回复你。回复的内容取决于你的OpenClaw设置，可能是简单的问候，也可能是更详细的介绍。
如果成功了
恭喜你！这意味着：
你的AI助手现在正式入驻飞书了。
如果没成功
别着急，这是正常现象。我专门准备了下一节，帮你排查各种问题。
五、常见问题
飞书接入过程中，90%的问题都集中在下面这几个。如果你遇到了问题，对照着检查一遍，基本都能解决。
问题1：机器人收不到消息
这是最常见的问题。机器人显示在线，但你发消息它没反应。
检查清单：
im.message.receive_v1事件。im:message等权限已经审核通过。问题2：在群里@机器人没反应
私聊能收到消息，但在群里@机器人就没反应。
这是因为缺少群聊权限。回到飞书开放平台，在权限管理里申请im:message.group_msg权限。
申请通过后，机器人就能在群里响应@消息了。
问题3：App Secret泄露了
如果你不小心把App Secret泄露了，或者怀疑泄露了，必须立刻处理。
处理步骤：
问题4：发消息失败提示权限不足
机器人能收到消息，但回复时提示权限不足。
检查im:message:send_as_bot权限是否已经申请并通过。这个权限是发送消息必需的。
另外，检查机器人是否被禁言。在飞书开放平台的"机器人"页面，确认机器人状态是"启用"。
六、实用进阶：让机器人只回复你
默认配置下，任何人给你的机器人发消息，它都会回复。这在家里用没问题，但如果你在团队里用，可能不希望别人随便使唤你的AI助手。
OpenClaw提供了精细的权限控制，让机器人只回复特定的人。
配置白名单模式
在OpenClaw的配置文件里，把dmPolicy设置为allowlist：
"channels": {
"feishu": {
"appId": "你的App ID",
"appSecret": "你的App Secret",
"dmPolicy": "allowlist", // 改为白名单模式
"enabled": true
}
}
}
配对流程
配置为白名单模式后，第一次有人给机器人发消息时，机器人不会直接回复，而是会生成一个配对码。
你需要手动批准这个配对请求：
- Code: ABC123, User: 张三, Time: 2026-04-18 10:30:00
批准后，这个用户就可以正常使用机器人了。你可以重复这个过程，添加多个信任的用户。
管理已配对用户
查看已经配对的用户：
取消某个用户的权限：
这个功能特别实用，既保证了安全性，又保持了灵活性。
结尾
到这里，OpenClaw接入飞书的完整流程就全部讲完了。说实话，步骤看起来有点多，但实际操作起来，顺利的话20分钟就能搞定。
一旦接入成功，你会发现整个世界都不一样了。
你的AI助手不再被困在电脑里，而是随时陪伴在你身边。你在路上想到什么，随时可以吩咐它去做。你在开会时需要什么资料，它立刻帮你准备好。你躺在床上不想动，它帮你处理各种琐事。
这就是数字管家的魅力——它不只是一个工具，而是一个真正能理解你、帮助你的伙伴。
而且这还只是开始。接入飞书后，OpenClaw的能力边界被大大扩展了。你可以让它帮你管理日程、整理文件、查询信息、甚至控制智能家居。只要你能想到的，它都能尝试去做。
下一篇，也是这个系列的倒数第二篇，我会分享3个让你用OpenClaw更顺手的设置技巧。这些技巧不会增加新的功能，但能让你的使用体验提升好几个档次。
比如如何设置快捷指令，如何优化响应速度，如何管理对话历史等等。都是实实在在能提高效率的小技巧。
好了，今天就到这里。赶紧去试试接入飞书吧，体验一下手机发一句话、电脑自动干活的快感。
如果在操作过程中遇到任何问题，随时可以回来查阅这篇文章。每个步骤我都尽量写得详细，每个常见问题我都提前想到了。
祝你一次成功，早日拥有自己的数字管家。
