升级OpenClaw v2026.5.3后飞书没声了-夜雨聆风

升级OpenClaw v2026.5.3后飞书没声了

假期升完 v2026.5.3，飞书那边发消息给 Bot，石沉大海。一开始以为是网络或者 Token 过期，翻了半天日志才发现是插件根本没加载起来。

gateway.err.log 里密密麻麻几行报错，核心是三个：

plugin not found: feishu (stale config entry ignored)
plugin must declare contracts.tools before registering agent tools
TypeError: (0 , _pluginSdk.resolveSenderCommandAuthorization) is not a function

01 | 根本原因，三个，缺一个都不行

插件改名了

飞书插件的 ID 从 feishu 改成了 openclaw-lark，但 openclaw.json 里没跟着改，网关压根找不到它。

Manifest 新增了必填字段

新版要求插件在 openclaw.plugin.json 里必须显式声明 channelConfigs 和 contracts.tools，缺了就拒绝注册工具。

SDK 拆包了

原来从 openclaw/plugin-sdk 统一 import 的几个方法，现在被拆到各自的子路径下，统一入口不再导出它们。旧代码跑到这里直接 TypeError，飞书消息进来就崩。

02 | 修复步骤

改三个地方，改完重启。

第一步：~/.openclaw/openclaw.json

把 plugins.entries 里的旧 feishu 块删掉，把 openclaw-lark 的 enabled 改成 true：

“plugins”: {
“allow”: [
“openclaw-lark”,

– “feishu”,
“openclaw-weixin”, … ],
“entries”: {
– “openclaw-lark”: {
– “enabled”: false
– },
– “feishu”: {

– “enabled”: true,

– “config”: {}

– },

+ “openclaw-lark”: {

+ “enabled”: true

+ },

第二步：~/.openclaw/extensions/feishu-openclaw-plugin/openclaw.plugin.json

在 JSON 最外层补上两个字段，紧接在 configSchema 后面：

“configSchema”: {
“type”: “object”,
“additionalProperties”: false,
“properties”: {}

– }

+ },

+ “channelConfigs”: {

+ “feishu”: {}

+ },

+ “contracts”: {

+ “tools”: true

+ }
}

第三步：~/.openclaw/extensions/feishu-openclaw-plugin/src/messaging/inbound/handler.js

把那行统一 import 拆成三行，对应各自的子路径：

– import { recordPendingHistoryEntryIfEnabled, DEFAULT_GROUP_HISTORY_LIMIT, resolveSenderCommandAuthorization, isNormalizedSenderAllowed } from ‘openclaw/plugin-sdk’;

+ import { recordPendingHistoryEntryIfEnabled, DEFAULT_GROUP_HISTORY_LIMIT } from ‘openclaw/plugin-sdk/reply-history’;

+ import { resolveSenderCommandAuthorization } from ‘openclaw/plugin-sdk/command-auth’;

+ import { isNormalizedSenderAllowed } from ‘openclaw/plugin-sdk/allow-from’;

如果 dispatch.js 等其他文件也有同样的报错，照这个思路对照官方 SDK Migration 文档逐一替换。

03 | 重启网关

ps aux | grep “gateway –port 18789” | grep -v grep | awk ‘{print $2}’ | xargs kill

杀掉之后守护进程会自动拉起，再跑一下：

tail -f ~/.openclaw/logs/gateway.err.log

没有报错说明修好了，回飞书发条消息验证一下。

04 | 小结

这次升级同时动了配置规范和 SDK 结构，三个问题叠在一起，单改一个还是不行。确认三步都做了再重启，飞书就通了。

你用的 OpenClaw 是什么版本？升级有没有踩到其他坑？

⭐点赞、转发、关注和推荐一键三连⭐