openclaw-weixin ​

把 OpenClaw 接入微信

社区维护的 OpenClaw 微信渠道插件，提供 npm 与 ClawHub 两个安装源。 本插件需要 OpenClaw >=2026.6.1。 OpenClaw 2026.9.1 / 2026.9.2 / 2026.9.4 的固定版本及运行环境 CI 覆盖见 兼容矩阵。

选择一种安装方式 ​

复制提示词 或 运行命令

让 OpenClaw 自动完成安装 ​

把下面这段话粘贴到 OpenClaw 聊天框并发送：

text
用 OpenClaw 官方 CLI 后台非交互安装/更新微信社区插件到最新版：已装沿源更新，不沿用旧版本号；新装优先 clawhub:openclaw-wechat，源不可用再用 npm:openclaw-weixin。
保留配置和登录态，确认在聊天中完成，最后核验版本

直接运行命令 ​

之前使用下方 ClawHub 或 npm 命令安装社区版： 运行 openclaw plugins update openclaw-weixin。

首次安装、替换腾讯官方包，或现有插件通过其他来源安装： 从下面任选一个安装命令，无需先卸载。 替换现有插件时，在所选安装命令末尾加 --force。配置和登录状态会保留。

ClawHub：openclaw-wechat ​

bash
openclaw plugins install clawhub:openclaw-wechat

npm：openclaw-weixin ​

bash
openclaw plugins install npm:openclaw-weixin

如果当前 OpenClaw 已有微信登录状态，安装后通常只需确认连接。 全新安装需要 展开完整检查并扫码绑定；安装报错、未自动恢复连接或需要确认目标账号时，也在此检查。

完整检查、扫码与恢复

安装命令报告版本不兼容 ​

仅在安装命令报告版本不兼容时检查：

bash
openclaw --version

需要 OpenClaw >=2026.6.1。若版本过低或 Nix 模式禁止安装，请不要卸载现有插件；按 安装限制与故障排查处理。

安装后没有自动连接 ​

安装可能使启用了配置重载的受管 Gateway 自动重载。若仍未连接，请重启实际承载 OpenClaw 的服务、容器或 Pod，然后执行：

bash
openclaw plugins list
openclaw channels status --probe

满足以下条件即表示连接成功：

  • openclaw plugins list 显示插件已启用，并且没有加载错误。
  • openclaw channels status --probe 对目标微信账号探测成功。
  • 使用多账号时，探测结果对应你准备使用的别名或账号 ID。
检查结果下一步
插件显示已停用执行 openclaw plugins enable openclaw-weixin，重载 Gateway，然后重新探测
插件无加载错误，且目标账号探测成功已完成，无需继续操作
账号显示未登录继续下面的扫码绑定
Channel 显示 OK 但未连接按连接故障排查重载实际运行单元

状态显示未登录 ​

仅在探测显示目标账号未登录时执行：

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

登录命令会在终端显示二维码。扫码并等待登录完成，然后再次执行：

bash
openclaw channels status --probe

多账号 ​

如果会同时使用多个微信账号，建议先按「账号 + 渠道 + 对端」隔离私聊上下文：

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

这是 OpenClaw 的全局会话设置，会影响所有渠道；它不影响账号登录，只决定之后收到的 私聊消息如何分配会话。

再次执行登录命令即可绑定其他微信账号。建议为每个号使用稳定别名，以便 openclaw.json / bindings 用可读 accountId（而不是仅服务端 hash）：

bash
openclaw channels login --channel openclaw-weixin --account wukong
openclaw channels login --channel openclaw-weixin --account nezha
账号 ID 与状态文件

登录成功后会写入：

  • openclaw-weixin/accounts/<ilink_bot_id 规范化>.json（凭证与状态命名空间；listAccountIds / monitor 只用此 id）
  • openclaw-weixin/account-aliases.json（一对一 alias → hash 逻辑映射，供 bindings / 出站解析；别名不会再起一条 transport）

未传 --account 时（宿主会传入 default 哨兵）只索引服务端 bot id，不会创建名为 default 的账号。已绑定过的 hash 账号再执行 login --account <alias> 时，会在 不歧义的情况下登记别名映射（不在线改名、不搬迁状态命名空间）。

凭证、账号 ID 和 context token 均为敏感数据；不要共享 ~/.openclaw/openclaw-weixin/ 下的状态文件。

主动与定时发送 ​

微信后端要求每条出站消息携带由该收件人入站消息下发的账号级 context token。插件收到 消息后会按账号保存该 token：

  • 尚未收到该收件人的消息或 token 缺失时，插件会拒绝发送消息，不会返回本地“成功” 结果。
  • 已保存的 token 仍可能失效；长时间无交互后发送失败时，请让收件人先向对应 bot 发送一条消息以刷新 token，再重试。

多账号部署的定时任务应同时显式设置 delivery.to 和 delivery.accountId。未指定 accountId 时，只有恰好能从账号级上下文选出一个账号才会发送；缺失或歧义都会失败。 context token 属于敏感数据，不要跨账号复制或写入任务配置。

文档与支持 ​