大家好,我是若风。
我的主力 Mac 在 2026 年 2 月 10 号配置过 OpenClaw,后来有段时间没在这台电脑上用,转到了备用的 Mac Air。

过了几周 OpenClaw 热度不降反升,昨天突然心血来潮再倒腾一下,升级(执行 openclaw update )了一下 OpenClaw 到最新的版本(更新后的版本为 2026.2.26 ,执行 openclaw --version 查看),发现 OpenClaw 的服务停摆,重启也不行,从日志上看到了一些蛛丝马迹,提示说飞书插件重复了
bash
plugins.entries.feishu: plugin feishu: duplicate plugin id detected;
later plugin may be overridden
安装了两个插件,一个是官方版本,一个是第三方开源社区版本。我当初采用第三方配置方式。
bash
# 官方版本插件安装位置
~/.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 隐藏目录也需要删掉,如果里面有重要的东西最好先备份一下,这个文件的位置一般在用户的根目录
bash
# 这是我电脑的绝对路径,把中间的用户名`ruofeng` 换成你登录的账号就是你们的路径
/Users/ruofeng/.openclaw
# 相对路径
~/.openclaw
备份命令
bash
mv .openclaw .openclaw-back
我安装完成后发现有两个文件, .openclaw 是你实际生效的目录

.openclaw 目录下的 workspace 文件都是非常重要的文件,里面的内容可以复用,可以让 AI 帮你合并一下

尝试 ChatGPT
今天起来直接换了一种方式,尝试 ChatGPT 来帮我定位问题,一路下来十几个来回终于搞定了
好消息是,从最终结果来看,飞书机器人那边( open.feishu.cn/app)的配置基本没太... JSON:
bash
# 新版本
{
"scopes": {
"tenant": [
"im:message",
"im:chat",
"contact:user.base:readonly",
"im:message:send_as_bot"
],
"user": [
"docx:document:readonly"
]
}
}
以前的配置
json
{
"scopes": {
"tenant": [
"im:message:send_as_bot",
"docx:document:readonly"
],
"user": [
"docx:document:readonly"
]
}
}
对比新增两项,注意这里的 tenant 列表是一个字符串列表不是 key-value (键值对)
arduino
{
"im:message",
"im:chat"
}

还有,更新配置后,记得在飞书后台重新发布一个新版本,配置才能生效。我这里创建了 0.0.3 版本。

下面附上 OpenAI 修复过程
OpenAI 修复过程回顾
一、事情的开始:它突然不回我了
10 天前还能正常用。
今天重新配置后:
- 本地 gateway 正常
- node 版本没问题
- 日志显示能收到飞书消息
- 但是飞书那边------毫无回应
终端里只有这一句:
csharp
feishu[main]: received message from ...
没有:
sql
agent turn start
model call
send message
这说明------
消息进来了,但 Agent 根本没启动。
二、第一层误导:端口问题
我看到:
arduino
connect ECONNREFUSED 127.0.0.1:18889
于是开始折腾端口。
- 18789
- 18889
- install
- uninstall
- launchctl
- stop
- start
结果发现:
👉 Gateway 其实早就跑着了
👉 Node 服务没跑
👉 端口根本不是问题
三、第二层误导:设备已经 Paired
我执行:
openclaw devices list
显示:
scss
Paired (2)
我以为:
已经配对成功了啊?
错。
那是本机 device 配对。
不是飞书用户配对。
四、真正的原因:Feishu 用户没有授权
当我在飞书发消息时,Bot 终于回了一句:
yaml
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
- 执行:
css
openclaw pairing approve feishu <code>
八、标准排查流程
css
① openclaw status
② openclaw logs --follow
③ openclaw devices list
④ 是否有 Pending → approve
⑤ 飞书是否返回 pairing code
⑥ openclaw pairing approve feishu <code>
OpenClaw 2026 最新的版本有三层模型:
层 1:服务是否运行
层 2:设备是否配对
层 3:飞书用户是否授权
我这次卡在第 3 层。
用过的命令清单
服务状态检查
bash
# 查看整体运行状态
# 用途
# - 检查 gateway 是否运行
# - 检查 node 是否 installed
# - 检查端口是否被占用
openclaw status
# 查看实时日志
# 用途: 确认流程走到了哪一步
openclaw logs --follow
设备层排查(Device Pairing)
bash
# 查看设备列表
# 用途
# - 查看:Paired 设备
# - 查看:Pending 请求
openclaw devices list
# 批准设备请求
# 场景:当你看到 Pending (1),说明 node 请求提升 role 或 scope。
openclaw devices approve <id>
飞书用户配对(核心问题)
飞书返回 pairing code
飞书提示:
yaml
OpenClaw: access not configured.
Pairing code: XXXXXXXX
说明:Feishu 用户还没被授权。
批准飞书用户配对(关键命令)
bash
openclaw pairing approve feishu <code>
# 执行后,用户才会进入 agent 流程
# 否则永远只停在:received message
配置查看
csharp
# 查看配置项
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 小时。
我已经替你踩过了。
希望大家都能愉快地和🦞一起玩耍。