feat: 新增 Gateway 配置保存和测试消息功能

新增功能:
- OpenClaw Gateway 配置支持修改保存(地址和 Token)
- 新增测试消息通信功能,可发送测试消息验证 Gateway 连接
- 添加 URL 清理按钮(移除末尾斜杠)
- 界面显示版本号 v1.0.0-fix7

修复:
- OpenClaw WebSocket 握手协议(等待 challenge 响应)
- 关闭窗口时事件处理器访问已销毁窗口的错误
- SSL/TLS 错误诊断和提示
- 连接状态管理优化

技术改进:
- 使用 challenge-response 握手机制连接 OpenClaw Gateway
- 添加窗口销毁检查避免事件发送失败
- 改进错误日志和诊断信息
- 优化连接状态更新逻辑
This commit is contained in:
2026-03-10 00:20:18 +08:00
parent 9cce1e76fc
commit fddd2b2e6b
7 changed files with 972 additions and 132 deletions

143
BUILD.md Normal file
View File

@@ -0,0 +1,143 @@
# 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 秒/次
- OpenClaw15 秒/次
- 自动重连:指数退避(最大 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