大家好，我是若风。
我的主力 Mac 在 2026 年 2 月 10 号配置过 OpenClaw，后来有段时间没在这台电脑上用，转到了备用的 Mac Air。
过了几周 OpenClaw 热度不降反升，昨天突然心血来潮再倒腾一下，升级（执行 openclaw update ）了一下 OpenClaw 到最新的版本（更新后的版本为 2026.2.26 ，执行 openclaw --version 查看），发现 OpenClaw 的服务停摆，重启也不行，从日志上看到了一些蛛丝马迹，提示说飞书插件重复了
plugins.entries.feishu: plugin feishu: duplicate plugin id detected;
later plugin may be overridden
安装了两个插件，一个是官方版本，一个是第三方开源社区版本。我当初采用第三方配置方式。
# 官方版本插件安装位置
~/.openclaw/extensions/feishu
# 社区开源版本
# Github地址：https://github.com/m1heng/clawdbot-feishu
~/.nvm/versions/node/v25.6.0/lib/node_modules/openclaw/extensions/feishu
这是⚠️警告信息
还有一个现象是，我在飞书上给 Bot 发信息没有任何反馈了，配置正常的话你给 Bot 发消息，它会马上对消息点击 Get 表情再进行处理，后面重新安装后出现了 OpenClaw: access not configured. 错误
Bot 正常效果
尝试解决
这个问题我开始以为很好解决。我让 OpenClaw 用 GLM 4.7 模型试，切换到 CLI 用 Claude Code + GLM 4.7 试，换成 MiniMax M2.5 还是不行😂。后来手动倒腾半天也没搞定，看来是新版本针对飞书和 Lark 的配置规则变了，旧配置因为缓存没删干净导致一直异常。
我太难了 😤
今天，索性重新走了一次从 0 到 1 的安装配置，把两个插件都删掉了， .openclaw 隐藏目录也需要删掉，如果里面有重要的东西最好先备份一下，这个文件的位置一般在用户的根目录
# 这是我电脑的绝对路径，把中间的用户名`ruofeng` 换成你登录的账号就是你们的路径
/Users/ruofeng/.openclaw
# 相对路径
~/.openclaw
备份命令
mv .openclaw .openclaw-back
我安装完成后发现有两个文件， .openclaw 是你实际生效的目录
.openclaw 目录下的 workspace 文件都是非常重要的文件，里面的内容可以复用，可以让 AI 帮你合并一下
尝试 ChatGPT
今天起来直接换了一种方式，尝试 ChatGPT 来帮我定位问题，一路下来十几个来回终于搞定了
好消息是，从最终结果来看，飞书机器人那边（ open.feishu.cn/app）的配置基本没太… JSON：
# 新版本
{
"scopes": {
"tenant": [
"im:message",
"im:chat",
"contact:user.base:readonly",
"im:message:send_as_bot"
],
"user": [
"docx:document:readonly"
]
}
}
以前的配置
{
"scopes": {
"tenant": [
"im:message:send_as_bot",
"docx:document:readonly"
],
"user": [
"docx:document:readonly"
]
}
}
对比新增两项，注意这里的 tenant 列表是一个字符串列表不是 key-value （键值对）
{
"im:message",
"im:chat"
}
还有，更新配置后，记得在飞书后台重新发布一个新版本，配置才能生效。我这里创建了 0.0.3 版本。
下面附上 OpenAI 修复过程
OpenAI 修复过程回顾
一、事情的开始：它突然不回我了
10 天前还能正常用。
今天重新配置后：
- 本地 gateway 正常
- node 版本没问题
- 日志显示能收到飞书消息
- 但是飞书那边——毫无回应
终端里只有这一句：
feishu[main]: received message from ...
没有：
agent turn start
model call
send message
这说明——
消息进来了，但 Agent 根本没启动。
二、第一层误导：端口问题
我看到：
connect ECONNREFUSED 127.0.0.1:18889
于是开始折腾端口。
- 18789
- 18889
- install
- uninstall
- launchctl
- stop
- start
结果发现：
👉 Gateway 其实早就跑着了
👉 Node 服务没跑
👉 端口根本不是问题
三、第二层误导：设备已经 Paired
我执行：
openclaw devices list
显示：
Paired (2)
我以为：
已经配对成功了啊？
错。
那是本机 device 配对。
不是飞书用户配对。
四、真正的原因：Feishu 用户没有授权
当我在飞书发消息时，Bot 终于回了一句：
OpenClaw: access not configured.
Pairing code: 8RZCKJWR
那一刻我才明白：
OpenClaw 2026 版本以后：
👉 每个飞书用户必须单独 approve
👉 就算是 owner 自己也不例外
五、最终解决命令
只需要这一句：
openclaw pairing approve feishu 8RZCKJWR
执行后再发消息——秒回。
六、为什么会这么设计？
新版 OpenClaw 增加了：
- 精细化角色控制
- scope 权限控制
- pairing approval
- groupPolicy 安全策略
这是为了防止：
- 被拉群滥用
- 提权攻击
- prompt injection
但副作用是：第一次配置极其容易踩坑。
七、完整排查路径总结
如果你遇到：
✔ 飞书发消息
✔ 本地日志显示 received
❌ 但 Bot 不回复
检查顺序：
openclaw statusopenclaw devices list- 看飞书是否返回 pairing code
- 执行：
openclaw pairing approve feishu <code>
八、标准排查流程
① openclaw status
② openclaw logs --follow
③ openclaw devices list
④ 是否有 Pending → approve
⑤ 飞书是否返回 pairing code
⑥ openclaw pairing approve feishu <code>
OpenClaw 2026 最新的版本有三层模型：
层 1：服务是否运行
层 2：设备是否配对
层 3：飞书用户是否授权
我这次卡在第 3 层。
用过的命令清单
服务状态检查
# 查看整体运行状态
# 用途
# - 检查 gateway 是否运行
# - 检查 node 是否 installed
# - 检查端口是否被占用
openclaw status
# 查看实时日志
# 用途: 确认流程走到了哪一步
openclaw logs --follow
设备层排查（Device Pairing）
# 查看设备列表
# 用途
# - 查看：Paired 设备
# - 查看：Pending 请求
openclaw devices list
# 批准设备请求
# 场景：当你看到 Pending (1)，说明 node 请求提升 role 或 scope。
openclaw devices approve <id>
飞书用户配对（核心问题）
飞书返回 pairing code
飞书提示：
OpenClaw: access not configured.
Pairing code: XXXXXXXX
说明：Feishu 用户还没被授权。
批准飞书用户配对（关键命令）
openclaw pairing approve feishu <code>
# 执行后，用户才会进入 agent 流程
# 否则永远只停在：received message
配置查看
# 查看配置项
openclaw config get <path>
# 查看 agent 自动回复配置
openclaw config get agents.defaults.autoReply
# 查看渠道配置
openclaw channels list
修复后的效果
飞书 App 端
让它帮我搜索一下 AI 领域的最新相关新闻，它提示需要 key
我尝试让它采用不用 key 的方式，它帮我找到了 10 条资讯，下面是前 1～5 条
下面是前 6～10 条，看了一下这些信息还是比较准确
Openclaw 网页端
CLI 端
执行 openclaw devices list
执行 openclaw status
最后
OpenClaw 很强。
但 2026 版的安全模型复杂度确实上来了。
如果你也是：
- 本地能收消息
- 但飞书没反应
大概率就是，你还没 approve 你的飞书账号。
希望这篇文章能救你 3 小时。
我已经替你踩过了。
希望大家都能愉快地和🦞一起玩耍。
