OpenClaw 飞书配置迁移导致消息丢失问题

问题发生时间

2026-03-03

问题描述

手动升级 OpenClaw 后，飞书机器人无法接收用户消息...

问题根因

升级过程中运行了 openclaw doctor --fix，配置结构发生变化。迁移过程中丢失了以下关键配置：

1. connectionMode: websocket — 飞书长链接模式
2. encryptKey — 加密密钥
3. verificationToken — 验证令牌
4. dmPolicy — 配对策略

解决过程

关键对话记录

小白: 让我检查飞书插件状态和日志

小白: 飞书权限正常。Gateway 进程在跑吗？

老大: (无回应)

小白: Gateway 在运行。老大，具体是啥问题？是说飞书发不了消息，还是收不到？

老大: 发消息 网关接不到

小白: 明白，消息事件没到 Gateway。检查下飞书事件订阅配置

小白: 问题找到了！Gateway 是 local 模式（localhost:18789），飞书服务器无法回调到本地。需要配置事件回调 URL

老大: 昨天还是正常使用的？

小白: 配置一样...奇怪。让我试试直接调用飞书工具看是否有响应

小白: API 正常！能调用飞书接口。问题是事件回调——飞书服务器推消息过来需要公网 URL

老大: im.message.receive_v1 飞书机器人我添加的有接收消息事件

小白: 那检查下 Gateway 有没有收到飞书的验证请求

小白: Gateway 在跑（返回200）。你在飞书开放平台配置的回调 URL 是啥？

老大: 事件订阅方式是长链接

小白: 长链接模式！那需要在 OpenClaw 配置里启用轮询

小白: 看到了！飞书支持 connectionMode: websocket（长链接）。配置里缺了这个

小白: 已添加 connectionMode: websocket（长链接模式）并重启。再试试？

老大: 我之前给你的有 APP ID APP secret 和Encrypt Key Verification Token

小白: 啊，缺了 Encrypt Key 和 Verification Token！让我补上

小白: 找到了！补上 encryptKey 和 verificationToken：配置全了！

老大: 小白？

小白: 收到啦！🎉 飞书消息恢复正常了！刚才配置缺了几个关键参数：connectionMode、encryptKey、verificationToken

openclaw修复过程

手动升级 OpenClaw 后，飞书机器人无法接收用户消息。通过排查发现：运行 doctor --fix 后配置结构发生变化，丢失了 connectionMode、encryptKey、verificationToken、dmPolicy 等关键字段。修复方法是在 accounts.default 下补充完整配置，并重启 Gateway。

教训总结

1. 备份配置文件：升级前备份 openclaw.json，保留多个 .bak 备份版本
2. 检查 doctor 改动：运行 doctor --fix 后，仔细检查改动了什么
3. 飞书配置必需字段：appId/appSecret、encryptKey、verificationToken、connectionMode
4. 长链接 vs Webhook：长链接模式需要 encryptKey + verificationToken，Webhook 模式需要公网回调 URL

相关配置

• OpenClaw 版本：2026.3.1
• Gateway 端口：18789
• Gateway 模式：local
• 飞书应用：cli_xxxxxxxxxxxx（你的APP_ID）