如何用 OpenClaw 接入官方微信插件?手把手教程

老九 | 2026-03-23

好消息！OpenClaw 现在支持微信了！🎉

经过一段时间的开发测试，官方微信插件终于来了。以后可以通过微信直接跟你的 OpenClaw AI 助手对话了。

这篇文章手把手教你如何安装配置。

一、什么是 OpenClaw 微信插件？

OpenClaw 微信插件是官方推出的微信渠道支持，通过扫码即可完成登录授权，让你的 AI 助手直接在微信里响应消息。

首先把你的微信升级到 8.0.70 版本，目前最新版本才能支持

支持的功能：

• • 文本消息收发
• • 图片/视频/文件发送
• • 输入状态提示（”正在输入…”）
• • 多账号同时在线
• • 会话上下文隔离（可选）

二、安装步骤

方式一：一键安装（推荐）

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

安装完成后，会让你通过微信扫码：

链接完成，开始用微信让你的 openclaw 干活吧。

方式二：手动安装

如果你的一键安装不生效，可以按以下步骤手动操作：

1. 安装插件

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

2. 启用插件

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

3. 扫码登录

openclaw channels login --channel openclaw-weixin

终端会显示一个二维码，用手机微信扫码并在手机上确认授权。

确认后，登录凭证会自动保存到本地，无需额外操作。

4. 重启 Gateway

openclaw gateway restart

三、添加更多微信账号

如果你有多个微信号需要接入：

openclaw channels login --channel openclaw-weixin

每次扫码登录都会创建一个新的账号条目，支持多个微信号同时在线！

四、会话隔离配置（重要！）

默认情况下，所有渠道的 AI 会话共享同一个上下文。如果希望每个微信账号的对话上下文相互隔离（不会串台）：

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

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

五、常见问题

Q1: 扫码后提示”授权失败”怎么办？

确保手机上确认的是「允许」而不是「拒绝」。如果持续失败，尝试重新运行登录命令。

Q2: 能收到消息但发不出去？

检查 Gateway 是否已重启：openclaw gateway status

Q3: 如何查看插件状态？

openclaw plugins list

Q4: 支持哪些消息类型？

目前支持：文本、图片、视频、文件、语音。

六、总结

快去试试吧！有问题随时在群里问我 🐞

公众号：甲虫傅里叶

本文参考 OpenClaw 官方文档