# WeCom OpenClaw Client - 构建说明

## ✅ 构建完成

**Windows 64 位版本已生成**

### 安装包位置
```
/home/admin/.openclaw/workspace/wecome-openclaw-client/dist/WeCom-OpenClaw-Client-v1.0.0-win64.zip
```

**文件大小**: 104MB  
**包含内容**: 
- WeCom OpenClaw Client.exe (主程序)
- Electron 运行时
- 应用资源

---

## 📦 安装和使用方法

### Windows 系统

1. **下载和解压**
   ```
   解压 WeCom-OpenClaw-Client-v1.0.0-win64.zip
   ```

2. **运行程序**
   ```
   双击 "WeCom OpenClaw Client.exe"
   ```

3. **配置机器人**
   - 点击"添加机器人"
   - 输入 Bot ID 和 Secret（从企业微信管理后台获取）
   - 点击"连接"

4. **配置 OpenClaw Gateway**
   - 默认地址：`ws://localhost:18789`
   - 如果启用了 Token 认证，填写 Token
   - 点击"连接 OpenClaw"

5. **测试**
   - 在企业微信中给机器人发送消息
   - 查看日志控制台确认消息转发
   - AI 回复会自动发送回企业微信

---

## 🔧 技术架构

### 双 WebSocket 长连接

```
企业微信用户 <---> 企业微信 WebSocket <---> 本客户端 <---> OpenClaw Gateway <---> AI 智能体
                    (云端)              (本地)         (本地)
```

### 消息转发流程

#### 企业微信 → OpenClaw
1. 用户在企业微信发送消息
2. 企业微信 WebSocket 推送消息到客户端
3. 客户端提取文本、媒体、引用等内容
4. 构建 OpenClaw 消息格式并转发
5. OpenClaw 路由到 AI 智能体处理

#### OpenClaw → 企业微信
1. AI 智能体生成回复
2. OpenClaw 通过 WebSocket 推送回复
3. 客户端接收回复消息
4. 使用流式消息发送到企业微信
5. 用户看到 AI 回复

### 心跳保活
- 企业微信：30 秒/次
- OpenClaw：15 秒/次
- 自动重连：指数退避（最大 100 次）

---

## 🛠️ 重新构建

如果需要重新构建：

```bash
cd /home/admin/.openclaw/workspace/wecome-openclaw-client

# 1. 构建 React 界面
npm run build:react

# 2. 打包 Windows 应用
npm run pack  # 生成 win-unpacked 目录

# 3. 创建 ZIP 包
cd dist
zip -r "WeCom-OpenClaw-Client-v1.0.0-win64.zip" win-unpacked/
```

---

## 📝 配置文件位置

应用配置保存在：
- Windows: `%APPDATA%\wecome-openclaw-client\config.json`

包含：
- Bot ID 和 Secret 列表
- OpenClaw Gateway 地址和 Token
- 自动连接设置

---

## 🔍 故障排查

### 连接企业微信失败
- 检查 Bot ID 和 Secret 是否正确
- 确认企业微信后台已开启"长连接"模式
- 查看日志控制台的错误信息

### 连接 OpenClaw 失败
- 确保 OpenClaw Gateway 已启动：`openclaw gateway status`
- 检查地址是否正确（默认 `ws://localhost:18789`）
- 如果启用了 Token，确认 Token 正确

### 消息不转发
- 检查两个连接是否都已建立（绿色状态指示器）
- 查看日志控制台是否有消息记录
- 确认企业微信机器人已正确配置

---

## 📞 技术支持

- 项目地址：http://192.168.1.191:23000/weworkdev/wecome-openclaw-client.git
- 联系方式：sales@toncent.com.cn

---

**构建时间**: 2026-03-09  
**版本**: 1.0.0  
**平台**: Windows 64-bit