更新时间2026.03.29openclaw-weixin 插件安装和升级微信官方的快速安装脚本npx -y tencent-weixin/openclaw-weixin-clilatest installtencent-weixin/openclaw-weixin-cli 这个 npm 包是 openclaw-weixin 插件的 installer。tencent-weixin/openclaw-weixin 这个 npm 包才是 openclaw-微信插件本身可以直接安装。注意 tencent-weixin/openclaw-weixin-cli 这个官方 installer 下载最多的 1.0.2 版本及之前的版本有一个严重 bug统一使用了 which 命令来查找 openclaw完全没有考虑到 windows 操作系统没有 which 而是使用 where 命令所以在 windows 系统中会因为无法找到 openclaw 直接退出安装。但这个错误版本已有十万人下载所以世界鹅厂真是个草台班子……所以更推荐手动安装 tencent-weixin/openclaw-weixin 插件 并扫码登录步骤更清晰# 直接安装微信插件 openclaw plugins install tencent-weixin/openclaw-weixin # 启用微信插件默认自动启用Channel显示OK但未连接可以手动启用 openclaw config set plugins.entries.openclaw-weixin.enabled true # 登录微信频道会弹二维码让你扫码可以重复运行登录多个微信 openclaw channels login --channel openclaw-weixin # 最后重启 openclaw gateway openclaw gateway restart注意每次运行 openclaw channels login --channel openclaw-weixin 扫码登录都会创建一个新的账号条目插件可以支持多个微信号同时在线。openclaw 微信插件的版本和兼容性OpenClaw 2026.3.22 版本的 Breaking Changes破坏性变更详见[4]对很多插件的适配都造成了重大影响根据腾讯在 npmjs.com 的文档openclaw-weixin 插件 2.0 以上版本针对 OpenClaw 2026.3.22 以上版本而 openclaw-weixin 插件 1.0.x 版本针对 OpenClaw 2026.3.22 之前的版本需要根据自身的 OpenClaw 版本进行选择。查看 OpenClaw 版本openclaw --version微信插件版本OpenClaw 版本npm dist-tag状态2.0.x2026.3.22latest活跃1.0.x2026.1.0 2026.3.22legacy维护中根据腾讯 OpenClaw 微信插件团队官方的文档插件在启动时会检查宿主版本如果运行的 OpenClaw 版本超出支持范围插件将拒绝加载。如果你用的是 OpenClaw 2026.3.13及以前的版本可以安装 legacy 版本# 快速安装脚本安装1.0.x版本微信插件 npx -y tencent-weixin/openclaw-weixin-clilegacy install # 手动安装1.0.x版本微信插件 openclaw plugins install tencent-weixin/openclaw-weixinlegacy安装后如需升级和卸载插件可以用如下命令# 升级到最新 open-claw 插件 openclaw plugins update openclaw-weixin # 卸载 openclaw-weixin 插件 openclaw plugins uninstall openclaw-weixin # 注意重启 openclaw gateway openclaw gateway restart多微信账号登录和会话上下文隔离每次运行openclaw channels login --channel openclaw-weixin扫码登录都会创建一个新的账号条目插件可以支持多个微信号同时在线。不同的 OpenClaw 初始化时的配置不同默认情况下所有渠道的 AI 会话可能共享同一个session的上下文。如果希望每个微信账号的对话上下文相互隔离需要设置openclaw config set agents.mode per-channel-per-peer这样每个「微信账号 发消息用户」组合都会拥有独立的 AI 记忆账号之间不会串台。openclaw-weixin 的 Cannot find module 错误2026.3.28更新本 bug 仅在 OpenClaw 2026.3.22 和 2026.3.23 版本存在OpenClaw 2026.3.24 版本已修复。另外微信插件的官方安装器 tencent-weixin/openclaw-weixin-cli 的 2.1.1 版本也已经内置了和本文完全相同的解决方案在检测到 OpenClaw 2026.3.22 和 2026.3.23 版本时会自动创建符号链接 (symlink)。/** Only OpenClaw 2026.3.22–2026.3.23 need node_modules/openclaw symlink for jiti. */ const SYMLINK_OPENCLAW_MIN 2026.3.22; const SYMLINK_OPENCLAW_MAX 2026.3.23;因此如果你是使用官方的快速安装脚本安装的 2.1.1 版本则无需手动处理。错误现象OpenClaw 版本在 2026.3.22 之后需要安装或升级到 openclaw-weixin 插件 2.0.1 或更高版本但2.0.1 版本在实际使用中出现 Cannot find module 错误。错误现象和日志如下14:42:18 [plugins] openclaw-weixin failed to load from /Users/claw/.openclaw/extensions/openclaw-weixin/index.ts: Error: Cannot find module openclaw/plugin-sdk/channel-config-schema Require stack: - /Users/claw/.openclaw/extensions/openclaw-weixin/index.ts [openclaw] Failed to start CLI: PluginLoadFailureError: plugin load failed: openclaw-weixin: Error: Cannot find module openclaw/plugin-sdk/channel-config-schema Require stack: - /Users/claw/.openclaw/extensions/openclaw-weixin/index.ts at maybeThrowOnPluginLoadError (file:///Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/pi-embedded-CbCYZxIb.js:149250:8) at loadOpenClawPlugins (file:///Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/pi-embedded-CbCYZxIb.js:149815:2) at ensurePluginRegistryLoaded (file:///Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/plugin-registry-D62zMn9j.js:28:2) at Object.callback (file:///Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/program-_bI5lB1z.js:135:5) at async Command.parseAsync (/Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/node_modules/commander/lib/command.js:1122:5) at async runCli (file:///Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/run-main-BV_z8OR1.js:420:3)openclaw-weixin 插件无法加载导致 openclaw gateway 也无法启动。错误原因错误是由于 openclaw 2026.3.22 版本后的变更和 bug且微信官方插件 V2.0.1 版本暂未完全适配导致具体如下。openclaw-weixin 插件的入口文件index.ts包含以下导入语句import { buildChannelConfigSchema } from openclaw/plugin-sdk/channel-config-schema;openclaw/plugin-sdk/channel-config-schema是 openclaw 主包package.json中exports字段定义的一个子路径导出{ exports: { ./plugin-sdk/channel-config-schema: { types: ./dist/plugin-sdk/channel-config-schema.d.ts, default: ./dist/plugin-sdk/channel-config-schema.js } } }对应的模块文件确实存在于 npm 全局安装的 openclaw 包文件夹内/Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/dist/plugin-sdk/channel-config-schema.js但是openclaw 使用 npm -g 全局安装时Node.js 无法从插件目录解析到 openclaw 包目录openclaw 使用 jiti一个 TypeScript/ESM 模块加载器的别名机制在全局安装场景下未正确生效。因此openclaw-weixin 插件的入口文件index.ts从插件目录向上逐级查找时无法找到全局安装的node_modules/openclaw 目录也就无法找到所需的模块文件。解决方案在 openclaw-weixin 插件目录内新建node_modules目录并创建一个指向 openclaw 包的符号链接使 Node.js 的标准模块解析能够找到openclaw包。第一步临时禁用插件# 如果影响 openclaw 正常使用可以暂时禁用 openclaw plugins disable openclaw-weixin第二步在插件目录内创建 node_modules 目录如不存在mkdir -p $HOME/.openclaw/extensions/openclaw-weixin/node_modules第三步创建符号链接连接到 openclaw 安装路径ln -s $(npm root -g)/openclaw $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw第四步验证符号链接# 确认链接存在且指向正确 ls -la $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw # 应显示openclaw - /Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw # 确认模块可以解析 cd $HOME/.openclaw/extensions/openclaw-weixin node -e import(openclaw/plugin-sdk/channel-config-schema).then(m console.log(Object.keys(m))) # 应输出[buildChannelConfigSchema, AllowFromListSchema, ...]第五步重新启用插件并重启 OpenClaw Gateway# 重新启用插件 openclaw plugins enable openclaw-weixin # 重启 openclaw gateway openclaw gateway restart重启后错误信息应不再出现微信通道正常加载。回滚方法如需回滚删除符号链接并重启即可# 删除符号链接 rm $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw # 重启 openclaw gateway openclaw gateway restart重要提示把这篇文章直接发给 openclaw 看可以直接让它帮你解决问题参考资料[1] npm - tencent-weixin/openclaw-weixin[2] npm - tencent-weixin/openclaw-weixin-cli[3] 墨滴 - 扫地升 - openclaw-weixin插件安装执行流程[4] wurang.net - OpenClaw 2026.3.22 版本更新解读