Skip to content

openclaw-weixin

English · 文档站点

这是 Tencent/openclaw-weixin 的社区维护发行版,用于连接 OpenClaw 与微信,并提供更好的使用体验。

安装或替换

需要 OpenClaw >=2026.6.1。请使用运行 OpenClaw 的同一用户,并在同一环境中执行。

命令行——一行安装或替换:

提示:不要先卸载 @tencent-weixin/openclaw-weixin;直接原位替换通常会保留现有配置和登录状态。

bash
openclaw plugins install npm:openclaw-weixin --force
绑定微信账号(全新安装)

如需将微信账号绑定到当前 OpenClaw,请启用插件并开始扫码绑定:

bash
openclaw plugins enable openclaw-weixin
openclaw channels login --channel openclaw-weixin

登录命令会在终端显示二维码。

重载检查

确保正在运行的 Gateway 已重载插件。必要时重启承载 OpenClaw 的服务、容器或 Pod,然后执行:

bash
openclaw plugins list
openclaw channels status --probe

插件无加载错误且目标账号探测成功即完成;若显示未登录,请执行上面的登录命令。

提示词自动安装

将下面的提示词直接发送 OpenClaw Agent,用于安全安装或原位替换插件:

text
请在不改变现有配置和登录状态的前提下,安装或原位替换 `openclaw-weixin`:
1. 先确认 `openclaw --version` 不低于 2026.6.1。
2. 我信任 npm 来源 `openclaw-weixin`。执行
   `openclaw plugins install npm:openclaw-weixin --force`,不要先卸载。
3. 仅在 `openclaw plugins list` 显示已停用时启用插件。不要主动重启 Gateway 或发起
   扫码登录;安装可能使启用了配置重载的受管 Gateway 自动重启。若已自动重启,执行
   `openclaw channels status --probe`;否则询问是否重启 Gateway。
4. 只报告结果;若未登录过微信,提示我手动运行
   `openclaw channels login --channel openclaw-weixin` 扫码绑定微信。

通过 Agent 命令安装

OpenClaw >=2026.7.2-beta.1 时,如果已设置 commands.plugins: true,并且你是 owner/admin,直接发送:

text
/plugins install npm:openclaw-weixin --force

然后按上面的重载检查操作。

多账号

再次执行登录命令即可绑定其他微信账号:

bash
openclaw channels login --channel openclaw-weixin

多个账号同时登录时,建议按「账号 + 渠道 + 对端」隔离上下文:

bash
openclaw config set session.dmScope per-account-channel-peer

文档