OpenClaw升级后微信接入没反应?手把手教你搞定插件安装错误

最近不少朋友升级完 OpenClaw 2026.3.23 之后，安装官方微信插件 @tencent-weixin/openclaw-weixin 遇到了错。今天整理一下最常见的两个错误，给大家一个完整的解决步骤。

错误现象

你可能会遇到这样类似的错误：

plugins.allow is empty; discovered non-bundled plugins may auto-loadopenclaw-weixin failed to loadError: Cannot find module 'openclaw/plugin-sdk'

或者装完了，微信就是没反应，收不到消息。

别慌，这不是什么大问题，就是几个配置和依赖的小事，一步步来。

第一步：给插件开绿灯 —— 配置插件白名单

OpenClaw 默认不允许加载第三方未认证插件，这是安全措施。你需要在配置里把微信插件加到允许列表：

编辑你的 OpenClaw 配置文件（一般是 ~/.openclaw/openclaw.json），加上这段：

{  "plugins": {    "allow": ["@tencent-weixin/openclaw-weixin"]  }}

如果你已经有 plugins 配置了，直接往 allow 数组里加 "@tencent-weixin/openclaw-weixin" 就行，不用整个替换。

第二步：解决 Cannot find module 'openclaw/plugin-sdk'

这个错误是说，插件找不到 OpenClaw 核心的插件开发SDK。有几种解决办法，按顺序试：

方法一：进入插件目录装依赖（最简单）

cd /Users/liudongping/.openclaw/extensions/openclaw-weixinnpm install

就这么简单，进去跑一遍 npm install，依赖就对上了。

方法二：如果你是全局安装的 OpenClaw —— 做个 npm link

# 如果你是把 OpenClaw 全局装的，link 一下让插件能找到核心模块cd /path/to/your-openclaw-sourcenpm link

做完之后插件就能找到 openclaw/plugin-sdk 了。

方法三：重新装一遍插件

有时候第一次安装依赖没对齐，卸载重装：

openclaw plugins uninstall "@tencent-weixin/openclaw-weixin"openclaw plugins install "@tencent-weixin/openclaw-weixin@latest"

第三步：重启网关，完事了

改完配置，装完依赖，一定要重启一下 OpenClaw 网关：

# 如果是 systemdsystemctl --user restart openclaw# 如果是 launchd (macOS)launchctl stop com.openclaw.gatewaylaunchctl start com.openclaw.gateway

重启完等个十几秒，再发消息试试，应该就通了。

常见问题

Q: 我还是错，说 "429 Rate limit exceeded" 怎么办？

A: ClawHub 限流了，不影响已经下载完的文件。你已经下完了，按照上面步骤改配置装依赖就行，不用管限流提示。

Q: 装完了还是收不到消息？

A: 检查这几样：

1. 1. 微信配置对不对 → AppID、AppSecret、token 这些填对了吗？
2. 2. 服务器端口通不通 → 服务器防火墙开了微信需要的端口了吗？
3. 3. 看日志 → journalctl -u openclaw --user -f 看一眼有什么新错误

Q: 我用的是 Docker 部署，也这么弄吗？

A: Docker 版本一般把配置做好了，很少有这个问题。如果遇到，你需要进容器改配置，步骤是一样的。

总结

其实就是两件事：

1. 1. 配置 → 一定要加 plugins.allow，默认不让第三方插件加载
2. 2. 依赖 → 进插件目录跑一遍 npm install 解决模块找不到

照着做，基本就能解决 90% 的安装问题。要是还有错，把日志放出来，我们一起看。

你装好了吗？有其他问题欢迎留言交流。