openclaw-weixin-installer

OpenClaw 微信消息通道插件的统一安装器。自动检测宿主 OpenClaw 版本，安装兼容的插件版本。

快速开始

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

安装器会自动完成以下步骤：

1. 检测本地 openclaw --version
2. 根据兼容矩阵选择合适的插件版本（dist-tag）
3. 调用 openclaw plugins install 安装对应版本
4. 引导扫码连接微信
5. 重启 OpenClaw Gateway

无需手动指定版本号。

兼容矩阵

| openclaw-weixin | 支持的 OpenClaw | dist-tag | 说明 | |-----------------|---------------------|----------|------------| | 1.0.x | >=2026.3.0 <2026.3.22 | legacy | 旧宿主维护线 | | 2.0.x | >=2026.3.22 | latest | 新宿主线 |

从 2.0.0 开始，插件采用独立 semver 版本号，不再对齐宿主 OpenClaw 版本号。

手动安装

如果需要手动指定版本，可以直接使用 openclaw 命令：

# 查看当前 OpenClaw 版本
openclaw --version

# 新宿主 (>=2026.3.22)：安装 latest 线
openclaw plugins install @tencent/openclaw-weixin@latest

# 旧宿主 (<2026.3.22)：安装 legacy 线
openclaw plugins install @tencent/openclaw-weixin@legacy

运行时版本校验

插件在启动时会自动检查宿主版本兼容性。如果版本不匹配，将立即抛出错误：

[openclaw-weixin] 宿主版本不兼容!
  当前 OpenClaw 版本: 2026.3.10
  当前插件支持范围:   >=2026.3.22
  请安装 openclaw-weixin@legacy (1.0.x (旧宿主线))
  或运行: npx @tencent-weixin/openclaw-weixin-cli install (自动选择兼容版本)

故障排查

宿主版本不兼容

症状：插件启动时报 宿主版本不兼容 错误。

解决：

# 1. 确认 OpenClaw 版本
openclaw --version

# 2. 用统一安装器重新安装（自动匹配版本）
npx -y @tencent-weixin/openclaw-weixin-cli install

如何安装 legacy 线

# 方式一：统一安装器（自动判断）
npx -y @tencent-weixin/openclaw-weixin-cli install

# 方式二：手动指定 dist-tag
openclaw plugins install @tencent/openclaw-weixin@legacy

如何查看当前 openclaw 版本

openclaw --version

发布策略

dist-tag 说明

| dist-tag | 对应版本线 | 说明 | |----------|-----------|------| | latest | 2.x | 新宿主线，npm install / openclaw plugins install 默认安装 | | legacy | 1.x | 旧宿主维护线，需显式指定 @legacy |

发布命令

# 发布新宿主线 (2.x)
npm run publish:external:latest -- patch
npm run publish:internal:latest -- patch

# 发布旧宿主维护线 (1.x)
npm run publish:external:legacy -- patch
npm run publish:internal:legacy -- patch

# dry run 预检
npm run publish:external:latest -- patch --dry-run

开发

# 安装开发依赖
npm install

# 本地测试 install 命令
node cli.mjs install