一、前置核查（必做）

1. 版本适配
   • 微信：iOS≥8.0.70、安卓≥8.0.69，未达标则更新至最新版。
   • OpenClaw：需为最新稳定版，执行openclaw --version验证，异常则重新获取部署包。
2. 环境与权限
   • 网络：开放 443、80 端口，确保与微信服务器网络互通。
   • 账号：个人微信完成实名认证、状态正常。
   • 依赖：安装 Node.js≥16.14.0、npm≥8.5.0 或 Docker≥20.10.0。

二、3 种部署模式（核心步骤）

1. 本地客户端部署（开发测试）

1. 安装 OpenClaw 客户端，首次启动选「开发模式」，执行初始化：

   bash

   运行

   openclaw init --mode local --channel weixin
   

2. 微信启用「微信 ClawBot」插件（未找到则重登 / 更微信 / 等 24 小时灰度）。
3. 客户端生成二维码，微信插件扫码授权，执行openclaw channels status验证连接状态。

2. 云端容器部署（生产环境）

1. 服务器配置（2 核 4G+，CentOS7.9+/Ubuntu20.04+），安装 Docker 并启动。
2. 创建目录并编写配置：

   bash

   运行

   mkdir -p /opt/openclaw/weixin && cd /opt/openclaw/weixin
   touch docker-compose.yml config.yml
   

   • 编辑docker-compose.yml（端口、镜像、挂载）；
   • 编辑config.yml（配置微信通道参数，正式环境开启 SSL）。
3. 启动容器：docker-compose up -d，查看日志确认无报错。
4. 生成二维码并拷贝至本地：

   bash

   运行

   docker exec -it openclaw-weixin openclaw channels generate-qrcode --channel weixin
   docker cp openclaw-weixin:/app/qrcode.png ./local-qrcode.png
   

5. 微信扫码绑定，查看日志确认「WeChat channel connected」。

3. 命令行部署（自动化脚本）

1. 安装命令行工具：npm install -g @tencent-weixin/openclaw-cli。
2. 一键部署微信通道：

   bash

   运行

   openclaw install --channel weixin --mode production --output /opt/openclaw
   

3. 自动生成配置与二维码，执行绑定指令完成连接。

三、生产环境优化

1. 稳定性
   • 配置心跳：heartbeat.interval=30s、timeout=10s、retry=3。
   • 多实例容灾：部署≥2 台实例，Nginx 负载均衡。
   • 数据持久化：日志、配置挂载至外部存储。
2. 性能
   • 容器资源限制：在docker-compose.yml中配置 CPU、内存上限。
   • 启用 Redis 消息队列缓冲请求。

四、常见故障速查