OpenClaw 个人微信插件安装教程（@tencent-weixin/openclaw-weixin）

插件信息

前置要求

• • OpenClaw 已安装并正常运行
• • OpenClaw 版本 >= 2026.3
• • 微信账号（用于扫码授权）

一、安装步骤

Step 1：一键安装（推荐）

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

这个命令会自动完成：安装插件 → 配置启用 → 引导登录

Step 1（备选）：手动安装

如果一键安装不成功，按以下步骤手动操作：

1.1 安装插件

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

1.2 启用插件

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

二、扫码登录

Step 2：执行扫码登录

openclaw channels login --channel openclaw-weixin

执行后终端会显示一个二维码。

Step 3：用微信扫码授权

1. 1. 打开手机微信
2. 2. 扫描终端显示的二维码
3. 3. 在手机上点击"确认授权"

授权成功后，登录凭证会自动保存到本地，不需要反复扫码。

三、启动服务

Step 4：重启 Gateway

openclaw gateway restart

Step 5：检查状态

openclaw status

确认微信渠道状态为"已连接"即可。

四、多账号配置

添加更多微信账号

每次执行扫码登录都会创建一个新的账号条目：

openclaw channels login --channel openclaw-weixin

支持多个微信号同时在线。

独立会话隔离（可选）

默认情况下，所有渠道共享同一个AI上下文。如果希望每个微信账号的对话独立：

openclaw config set agents.mode per-channel-per-peer

这样每个「微信账号 + 发消息用户」组合都会有独立的AI记忆。

五、配置参数说明

插件配置项

完整配置示例

{
  "channels": {
    "openclaw-weixin": {
      "enabled":true
    }
  },
  "agents": {
    "defaults": {
      "mode": "per-channel-peer"
    }
  }
}

六、功能支持

七、常见问题

Q1：扫码后提示"环境异常"

这是微信的安全机制，新账号或长期不活跃账号容易遇到。

解决方法：

1. 1. 在微信安全中心解除限制
2. 2. 换一个活跃的微信账号尝试
3. 3. 在常用设备上先登录微信，再扫码

Q2：二维码显示不完整/无法扫描

1. 1. 终端窗口可能太小，放大窗口后再试
2. 2. 尝试使用浏览器方式登录：

openclaw channels login --channel openclaw-weixin --browser

Q3：提示"登录态失效"

需要重新扫码授权：

openclaw channels logout --channel openclaw-weixin
openclaw channels login --channel openclaw-weixin

Q4：消息发送成功但收不到回复

1. 1. 检查Gateway状态：openclaw status
2. 2. 检查微信插件是否正常加载
3. 3. 尝试重启Gateway：

openclaw gateway restart

Q5：多个账号如何区分？

多账号登录后，会自动分配不同的账号ID。可以通过日志查看消息是从哪个账号收到的。

八、工作原理（技术说明）

通信架构

本插件通过 HTTP JSON API 与微信后端网关通信：

微信用户 → 微信服务器 → 本插件 → OpenClaw AI
                                              ↓
微信用户 ← 微信服务器 ← 本插件 ← OpenClaw AI 回复

核心接口

消息加密

所有媒体文件（图片/语音/文件/视频）通过 CDN 传输，使用 AES-128-ECB 加密。

九、与企业微信方案对比

十、注意事项

1. 1. 扫码授权后凭证自动保存，不需要反复登录
2. 2. 建议使用活跃账号，新账号可能出现安全限制
3. 3. 不要在测试阶段用主力账号，先用小号测试
4. 4. 定期更新插件，修复潜在问题
5. 5. 多账号登录：每次扫码创建新账号，最多支持5个

十一、卸载/禁用

如果需要暂时禁用微信插件：

openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

完全卸载：

openclaw plugins uninstall openclaw-weixin

十二、相关资源

• • 插件源码：@tencent-weixin/openclaw-weixin
• • OpenClaw官方文档：https://docs.openclaw.ai

有问题欢迎留言～ 🍵