想把 AI 助手塞进微信？三步搞定。

前提

  • 已安装 OpenClaw（openclaw --version 确认）
  • 一个能扫码的微信号

第一步：安装插件

推荐一键安装：

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 channels login --channel openclaw-weixin

终端弹出二维码 → 微信扫码 → 确认登录。凭证自动保存，无需额外操作。

多账号？ 重复执行登录命令即可，建议隔离会话：

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

第三步：重启网关

openclaw gateway restart

完成。你的 AI 助手已经在微信里了。

第四步：配对认证

默认新联系人需要批准后才能对话：

openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>

配对码 1 小时过期。想开放访问？参考配对文档。

常见问题速查

现象解决
插件加载失败检查版本：v2.x 需要 OpenClaw ≥2026.3.22
网关反复重启更新插件和 OpenClaw 到最新版
TypeScript 入口报错npm 包缺少编译产物，重装或等发布方修复
收不到消息检查配对状态：openclaw pairing list openclaw-weixin

可选：自定义 Bot 标识

在 openclaw.json 中加入：

{
  "channels": {
    "openclaw-weixin": {
      "botAgent": "MyBot/1.0"
    }
  }
}

方便在后台日志里追踪自己的流量。

就这些。现在你可以用终端回复微信消息——AI 助手随身带着走。