OpenClaw 接入个人版微信教程

环境：Windows 10，OpenClaw 2026.3.24，插件 @tencent-weixin/openclaw-weixin@2.0.1

---

背景

OpenClaw 是一款支持插件扩展的 AI 网关工具，通过官方微信插件 @tencent-weixin/openclaw-weixin，可以将个人微信账号作为消息通道接入，实现 AI Bot 与微信的联动。本文记录完整的安装流程及遇到的问题解决过程。

---

安装流程

第一步：尝试一键安装脚本（遭遇限流）

官方提供了一键安装命令：

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

运行后检测到本地已安装 OpenClaw 2026.3.24，匹配兼容版本 2.0.x，但随即报错：

ClawHub /api/v1/packages/%40tencent-weixin%2Fopenclaw-weixin failed (429): Rate limit exceeded

ClawHub（OpenClaw 的插件仓库）触发了速率限制，一键脚本安装失败。CLI 提示改为手动执行：

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

第二步：手动安装插件

直接执行手动安装命令，第一次仍遇到 429 限流。稍等片刻后重试，第二次成功：

Downloading @tencent-weixin/openclaw-weixin@latest…
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-weixin（manifest id），而非 npm 包名 @tencent-weixin/openclaw-weixin。

第三步：启用插件

安装完成后，插件默认未启用，需手动开启：

openclaw config set plugins.entries.openclaw-weixin.enabled true

输出：

Updated plugins.entries.openclaw-weixin.enabled. Restart the gateway to apply.

此时若不重启，后续命令也可正常继续（channels login 命令会自动加载插件）。

第四步：扫码登录微信

执行登录命令，OpenClaw 会在终端渲染二维码：

openclaw channels login --channel openclaw-weixin

终端输出 ASCII 二维码，使用微信扫描即可完成授权。若终端二维码渲染异常，可通过命令输出中的备用链接在浏览器中打开扫码：

https://liteapp.weixin.qq.com/q/...

扫码完成后，终端显示：

✅ 与微信连接成功！

至此，个人微信账号已成功接入 OpenClaw 作为消息通道。

---

问题汇总

问题	原因	解决方案
429 Rate limit exceeded	ClawHub 插件仓库限流	等待数秒后重试手动安装命令
安全警告 dangerous code patterns	插件扫描机制误报	确认为官方插件后忽略，正常继续
manifest id 与 npm 包名不一致	插件命名规范差异	配置时统一使用 openclaw-weixin
plugins.allow is empty 警告	未配置插件白名单	非必须，如需消除可执行 openclaw config set plugins.allow '["openclaw-weixin"]'

---

完整命令速查

# 1. 安装插件（若失败重试即可）
openclaw plugins install "@tencent-weixin/openclaw-weixin@latest"

# 2. 启用插件
openclaw config set plugins.entries.openclaw-weixin.enabled true

# 3. 扫码登录微信
openclaw channels login --channel openclaw-weixin