OpenClaw 微信插件 Windows 安装完整指南


让 AI 助手连接你的微信,实现智能消息处理和自动化操作






-
Windows 10/11
-
已安装 Node.js(建议 v18 或更高版本)
-
已安装 npm 包管理器




在 PowerShell 中运行以下命令确认环境:
检查 Node.js 版本 node –version
检查 npm 版本 npm –version






验证安装:




微信插件 CLI 需要知道 openclaw 的安装位置。
临时设置(当前终端会话有效):
永久设置(推荐):
⚠️ 设置永久环境变量后,需要重新打开终端才能生效。








安装完成后会自动显示二维码,使用手机微信扫码完成授权。
⏱️ 注意: 二维码有效期约 60 秒,请尽快扫描!






原因: 微信插件 CLI 无法定位 openclaw 的安装位置
解决方案:
方法 1:临时设置环境变量后重新运行
$env:OPENCLAW_PATH=”C:\Users\zengz\AppData\Roaming\npm\openclaw.cmd”
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
方法 2:永久设置(设置后重启终端)
[Environment]::SetEnvironmentVariable(“OPENCLAW_PATH”, “C:\Users\zengz\AppData\Roaming\npm\openclaw.cmd”, “User”)




解决方案:
-
看到二维码后立即用微信扫描 -
如果 3 次都过期,需要重新运行登录命令:




原因: PowerShell 中两条命令不能直接用空格分隔
错误写法:
$env:OPENCLAW_PATH=”…” npx -y … ❌ 空格分隔




原因: 二维码刷新次数用尽(最多 3 次)
解决方案:
重新发起登录
openclaw channels login –channel openclaw-weixin




原因: 没有全局安装权限
解决方案:
以管理员身份打开 PowerShell 重新运行安装命令,或修改 npm 默认目录:
创建 npm 全局目录
mkdir C:\npm
npm config set prefix C:\npm
将 C:\npm 添加到 PATH 环境变量




安装成功后,可以检查以下内容:
# 1. 检查插件目录




| 命令 | 说明 |
openclaw channels login --channel openclaw-weixin | 微信扫码登录
openclaw channels list | 查看已连接的频道
openclaw channels logout --channel openclaw-weixin | 退出微信登录
openclaw status | 查看运行状态
openclaw restart | 重启 Gateway




⚠️ 重要: 安装过程中可能出现以下警告:
这是静态代码分析的安全提示。该插件是腾讯官方出品,用于微信消息处理,使用时请注意:
-
仅从官方 npm 源安装: @tencent-weixin/openclaw-weixin-cli -
不要将账号借给他人使用 -
定期检查已连接的应用权限




-
官方文档:https://docs.openclaw.ai
-
GitHub 仓库:https://github.com/tencent-weixin/openclaw-weixin
-
问题反馈:在项目仓库提交 Issue


祝你使用愉快!🎉觉得有用点个关注,后期会不定时推送有用信息。
夜雨聆风