乐于分享
好东西不私藏

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

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

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


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

  • 想用 AI 查资料、写文章,但电脑不在手边
  • 突然有个想法想问一下 AI,得等到坐在电脑前才行
  • 在微信上看到一篇好文章,想让 AI 帮忙总结,却要复制粘贴好几个地方

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

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


OpenClaw + 微信可以做什么?

  • 随时提问
    :手机不在身边?微信发一条,立刻得到回答
  • 处理文档
    :把文件发给它,让它帮你总结、改写、翻译
  • 群聊 AI
    :在群里 @它,全员都能用,头脑风暴神器
  • 多账号隔离
    :工作号、生活号 AI 记忆互不干扰,完全独立

二、安装方式选择

方式一:一键安装(推荐)

一条命令搞定一切:

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

扫码步骤:

  1. 打开手机微信
  2. 用微信扫一扫扫描终端里的二维码
  3. 在手机端确认授权
  4. 凭证自动保存到本地,无需额外操作

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


四、重启 Gateway 使生效

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 与后端网关通信,支持文本/图片/语音/文件/视频消息类型。