文章目录OpenClaw 接入个人版微信教程背景安装流程第一步尝试一键安装脚本遭遇限流第二步手动安装插件第三步启用插件第四步扫码登录微信问题汇总完整命令速查OpenClaw 接入个人版微信教程环境Windows 10OpenClaw 2026.3.24插件 tencent-weixin/openclaw-weixin2.0.1背景OpenClaw 是一款支持插件扩展的 AI 网关工具通过官方微信插件tencent-weixin/openclaw-weixin可以将个人微信账号作为消息通道接入实现 AI Bot 与微信的联动。本文记录完整的安装流程及遇到的问题解决过程。安装流程第一步尝试一键安装脚本遭遇限流官方提供了一键安装命令npx-ytencent-weixin/openclaw-weixin-clilatestinstall运行后检测到本地已安装 OpenClaw 2026.3.24匹配兼容版本2.0.x但随即报错ClawHub /api/v1/packages/%40tencent-weixin%2Fopenclaw-weixin failed (429): Rate limit exceededClawHubOpenClaw 的插件仓库触发了速率限制一键脚本安装失败。CLI 提示改为手动执行openclaw pluginsinstalltencent-weixin/openclaw-weixinlatest第二步手动安装插件直接执行手动安装命令第一次仍遇到 429 限流。稍等片刻后重试第二次成功Downloading tencent-weixin/openclaw-weixinlatest… Extracting …tencent-weixin-openclaw-weixin-2.0.1.tgz… Installed plugin: openclaw-weixin Restart the gateway to load plugins.注意安装过程中会出现以下安全警告属于已知提示不影响使用WARNING: Plugin openclaw-weixin contains dangerous code patterns: Shell command execution detected (child_process) (src/log-upload.ts:76) Environment variable access combined with network send — possible credential harvesting (src/messaging/process-message.ts:428)该警告由 OpenClaw 的插件沙箱扫描机制触发。插件为腾讯微信官方出品child_process用于启动微信进程通信网络访问用于消息上报属于正常功能实现。如对安全性有顾虑可自行审查源码后再决定是否安装。另外安装时还会出现如下提示Plugin manifest id openclaw-weixin differs from npm package name tencent-weixin/openclaw-weixin; using manifest id as the config key.这意味着后续所有配置命令中插件标识符应使用openclaw-weixinmanifest id而非 npm 包名tencent-weixin/openclaw-weixin。第三步启用插件安装完成后插件默认未启用需手动开启openclaw configsetplugins.entries.openclaw-weixin.enabledtrue输出Updated plugins.entries.openclaw-weixin.enabled. Restart the gateway to apply.此时若不重启后续命令也可正常继续channels login命令会自动加载插件。第四步扫码登录微信执行登录命令OpenClaw 会在终端渲染二维码openclaw channels login--channelopenclaw-weixin终端输出 ASCII 二维码使用微信扫描即可完成授权。若终端二维码渲染异常可通过命令输出中的备用链接在浏览器中打开扫码https://liteapp.weixin.qq.com/q/...扫码完成后终端显示✅ 与微信连接成功至此个人微信账号已成功接入 OpenClaw 作为消息通道。问题汇总问题原因解决方案429 Rate limit exceededClawHub 插件仓库限流等待数秒后重试手动安装命令安全警告dangerous code patterns插件扫描机制误报确认为官方插件后忽略正常继续manifest id 与 npm 包名不一致插件命名规范差异配置时统一使用openclaw-weixinplugins.allow is empty警告未配置插件白名单非必须如需消除可执行openclaw config set plugins.allow [openclaw-weixin]完整命令速查# 1. 安装插件若失败重试即可openclaw pluginsinstalltencent-weixin/openclaw-weixinlatest# 2. 启用插件openclaw configsetplugins.entries.openclaw-weixin.enabledtrue# 3. 扫码登录微信openclaw channels login--channelopenclaw-weixin