大家好，我是若风。
我的主力 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: access not configured.
Pairing code: XXXXXXXX
OpenClaw 2026 授权模型解析
OpenClaw 2026 版本引入了新的三层授权模型，理解这个模型是解决问题的关键：
层 1：服务是否运行（gateway + node service）
层 2：设备是否配对（device pairing）
层 3：飞书用户是否授权（user pairing approval）
核心变化：2026 版本要求每个飞书用户必须单独完成授权（pairing approval），包括 Bot Owner 自己。这是新版本增加的安全策略，用于防止：
- 被拉群滥用
- 提权攻击
- Prompt Injection
大多数配置问题发生在第 3 层。
解决方案
1. 确认问题现象
执行以下命令检查日志：
openclaw logs --follow
如果日志显示：
feishu[main]: received message from ...
但没有后续的 agent turn start、model call、send message，说明消息已接收但 Agent 未启动。
2. 执行飞书用户授权
当飞书返回 pairing code 时，执行以下命令完成授权：
openclaw pairing approve feishu <pairing_code>
例如：
openclaw pairing approve feishu 8RZCKJWR
执行后，用户才会进入 agent 流程，否则会永远停在 received message 阶段。
3. 更新飞书权限配置（如需要）
进入飞书开放平台，在"权限管理"中点击"批量导入"，更新以下权限配置：
{
"scopes": {
"tenant": [
"im:message",
"im:chat",
"contact:user.base:readonly",
"im:message:send_as_bot"
],
"user": ["docx:document:readonly"]
}
}
注意：tenant 列表是字符串数组，不是键值对。
更新后记得在飞书后台发布新版本，配置才会生效。
标准排查流程
遇到飞书机器人不回复问题时，按以下顺序排查：
# 1. 检查服务状态
openclaw status
# 2. 查看实时日志
openclaw logs --follow
# 3. 检查设备配对状态
openclaw devices list
# 4. 如有 Pending 请求，批准设备
openclaw devices approve <id>
# 5. 检查飞书是否返回 pairing code
# 6. 执行飞书用户授权
openclaw pairing approve feishu <code>
常用命令速查
服务状态检查
# 查看整体运行状态
openclaw status
# 查看实时日志
openclaw logs --follow
设备层排查
# 查看设备列表
openclaw devices list
# 批准设备请求（当看到 Pending 时）
openclaw devices approve <id>
飞书用户配对
# 批准飞书用户配对
openclaw pairing approve feishu <code>
配置查看
# 查看配置项
openclaw config get <path>
# 查看 agent 自动回复配置
openclaw config get agents.defaults.autoReply
# 查看渠道配置
openclaw channels list
问题诊断对照表
| 现象 | 可能原因 | 解决命令 |
|---|---|---|
| 本地能收消息，飞书无反应 | 飞书用户未授权 | openclaw pairing approve feishu <code> |
| 设备显示 Pending | 设备请求提升权限 | openclaw devices approve <id> |
| 服务无法启动 | Gateway/Node 服务异常 | 检查 openclaw status，重启服务 |
| 插件冲突警告 | 多个飞书插件共存 | 删除重复插件，清理缓存 |
总结
OpenClaw 2026 版本的安全模型复杂度有所提升，初次配置时容易在用户授权环节出现问题。
如果遇到：
- 本地日志显示
received message - 但飞书端没有任何回复
大概率是飞书用户还未完成授权。执行 openclaw pairing approve feishu <code> 即可解决。
