OpenClaw 微信连接教程:踩坑与解决方案(oc版本2026.03.23)

今天早上成功将微信（通过 openclaw-weixin 插件）绑定到 OpenClaw，实现 AI 助手在微信直接对话。整个过程踩了几个坑，分享经验给你。

第一步：安装微信插件

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

⚠️ 问题 1：插件加载失败 —— 找不到 openclaw/plugin-sdk

错误信息：

Cannot find module 'openclaw/plugin-sdk'

原因： 插件安装在扩展目录 ~/.openclaw/extensions/openclaw-weixin/，但 Node.js 无法解析全局安装的 openclaw 模块。

解决方案： 建立符号链接：

mklink /D "C:\Users\Administrator\.openclaw\extensions\openclaw-weixin\node_modules\openclaw" "C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw"

⚠️ 问题 2：函数不存在

错误信息：

TypeError: (0 , _pluginSdk.resolvePreferredOpenClawTmpDir) is not a function

原因： OpenClaw 版本太旧（2026.3.22），微信插件需要 2026.3.23 才有的函数。

解决方案： 升级 OpenClaw：

cmd /c "npm install -g openclaw@2026.3.23"

💡 关键技巧：在 Windows 上用 cmd /c 执行 npm 命令可以避免 PowerShell 的兼容性问题。

升级后需要重新建立符号链接，然后重启网关：

openclaw gateway restart

第二步：扫码登录

重启后，执行登录命令：

openclaw channels login --channel openclaw-weixin

这时会显示二维码。如果命令行里的 ASCII 艺术二维码用微信扫不上（这是常态 😅），可以生成一张可扫描的图片：

openclaw channels login --channel openclaw-weixin --qr-output wechat-qr.png

然后用微信扫图片中的二维码即可。

经验总结

有问题欢迎留言交流！