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:
143
BUILD.md
Normal file
143
BUILD.md
Normal 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 秒/次
|
||||
- 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
|
||||
Reference in New Issue
Block a user