OpenClaw 对接微信:扫码即连,5分钟搞定(完整教程)

适合读者： 想要在微信里直接使用 OpenClaw AI 的用户预计耗时： 5 分钟前提： 已安装 OpenClaw（openclaw CLI 可用）

你有没有遇到过这些情况？

接入 OpenClaw 后，你在微信里直接发消息，AI 秒回，就像跟朋友聊天一样自然。

不用开电脑，不用打开任何 App，掏出手机、打开微信就行。

一条命令搞定一切：

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

分三步走：

第一步：安装插件

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

第二步：启用插件

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

第三步：配置信任白名单

编辑 ~/.openclaw/openclaw.json，在 plugins 下添加：

{"plugins":{"allow":["openclaw-weixin"]}}

运行以下命令，会在终端显示一个二维码：

openclaw channels login --channel openclaw-weixin

扫码步骤：

如果终端二维码显示不完整或模糊，按 Ctrl+L 或调整终端字体大小刷新显示。

openclaw gateway restart

重启完成后，OpenClaw 会自动加载微信频道。

如果你有多个微信账号接入，希望每个账号的对话历史互不干扰，运行：

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

这样每个「微信号 + 发消息用户」组合都会有独立的 AI 记忆，互相不会串台。

同一条命令反复运行，每次扫码会创建一个新的账号条目：

openclaw channels login --channel openclaw-weixin

支持多个微信号同时在线，各自独立运行。

向你的微信号发一条消息，比如：

你好

如果 OpenClaw 在微信里回复了，说明接入完全正常。

Q：用微信接入，聊天记录安全吗？

OpenClaw 运行在你自己的服务器或电脑上，微信只是消息通道，AI 处理过程不经过第三方服务器。

Q：扫码后提示授权过期怎么办？

重新运行 openclaw channels login --channel openclaw-weixin，再次扫码授权即可，凭证会自动更新。

Q：终端没有显示二维码，或显示乱码？

Windows 用户建议用 Windows Terminal 或 PowerShell 7+ 运行命令，避免编码问题。macOS/Linux 终端直接支持，无此问题。

Q：重启后连不上？

openclaw gateway status

显示 active (running) 即为正常，否则运行 openclaw gateway start 启动服务。

Q：电脑关机了，微信里还能用吗？

不能。OpenClaw 需要保持运行状态（相当于一台常开的"AI 服务器"），关机后微信里自然也无法响应。

Q：支持企业微信吗？

目前插件主要面向个人微信，企业微信接入方式略有不同，可参考插件 GitHub 页面的说明。

项目	内容
插件名称	openclaw-weixin
安装来源	@tencent-weixin/openclaw-weixin
授权方式	微信扫码
多账号支持	是

插件通过 HTTP JSON API 与后端网关通信，支持文本/图片/语音/文件/视频消息类型。