WeChat

先讲这一页到底在解决什么

WeChat：消息从哪扇门跑进来

WeChat 像一扇接消息的门。你要看清门铃装在哪、钥匙交给谁、什么人能进来，以及门口最容易被绊一跤的是哪块砖。原文最响的一记鼓点，其实是：OpenClaw connects to WeChat through Tencent's external @tencent-weixin/openclaw-weixin…。

原文共 10 节，先看 Start Here 路径：/channels/wechat 查看官方原文

第一站

先把名字认清，不然命令很容易写错

这一页有好几个相近名字，它们不是在绕口令，而是在说不同层级的东西。

1

这是给读者看的产品名字，也就是大家熟悉的微信。

2

Weixin

这是腾讯包名和插件 ID 里常用的名字。

3

`openclaw-weixin`

这是 OpenClaw 里真正要写进命令和配置的频道 ID。

4

`@tencent-weixin/openclaw-weixin`

这是 npm 上那只插件包，像给 OpenClaw 装微信语言包。

第二站

安装这一步，就是先把“会微信的门卫”请进来

OpenClaw 核心只负责通用通道规则，微信自己的登录、媒体和账号监控由外部插件负责。

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

这是最快安装法，像直接请安装小助手把插件放好。

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

这是手动安装法，适合你想一步步看清插件登记过程。

plugins.entries.openclaw-weixin.enabled true

装上不等于开门，这个开关才是在说“让微信通道开始值班”。

openclaw gateway restart

重启 Gateway 像重新点名，让新来的插件正式加入队伍。

第三站

扫码登录要在 Gateway 那台机器上做

这不是填一串 token 的路线，而是让手机微信扫二维码，把账号凭证存在本机状态目录里。

openclaw channels login --channel openclaw-weixin

这句像对 OpenClaw 说：“把微信二维码登录窗口拿出来。”

手机扫码确认

用微信扫一扫确认登录，成功后插件会把账号凭证收好。

多个微信账号

再跑一次登录命令就能加第二个账号；私聊会按账号、频道和发送者分清楚。

session.dmScope per-account-channel-peer

这像给每个账号和联系人各开一本独立聊天本，避免不同门口来的消息混在一起。

第四站

陌生人来私聊时，还是按 OpenClaw 的配对规则守门

微信插件负责接消息，能不能让某个人继续聊，则交给 OpenClaw 的 pairing 和 allowlist 模型。

openclaw pairing list openclaw-weixin

像打开门卫登记册，看看现在有哪些人拿着号码牌等审批。

openclaw pairing approve openclaw-weixin <CODE>

这句像盖章放行，让对应的微信私聊可以继续往里走。

能力边界

当前说明强调私聊和媒体支持，群聊能力没有被插件元数据正式宣传出来。

排查方向

如果连不上，先看插件是否安装并启用，再看 OpenClaw 版本、插件版本和 Gateway 日志。

最后总结

把 WeChat 这页压成一句话

它不是 OpenClaw 核心自带的一扇门，而是外部插件装上的微信小门：先安装，后扫码，再用 pairing 决定谁能进来聊天。