徐总
fddd2b2e6b
新增功能: - OpenClaw Gateway 配置支持修改保存（地址和 Token） - 新增测试消息通信功能，可发送测试消息验证 Gateway 连接 - 添加 URL 清理按钮（移除末尾斜杠） - 界面显示版本号 v1.0.0-fix7 修复: - OpenClaw WebSocket 握手协议（等待 challenge 响应） - 关闭窗口时事件处理器访问已销毁窗口的错误 - SSL/TLS 错误诊断和提示 - 连接状态管理优化 技术改进: - 使用 challenge-response 握手机制连接 OpenClaw Gateway - 添加窗口销毁检查避免事件发送失败 - 改进错误日志和诊断信息 - 优化连接状态更新逻辑
144 lines
3.1 KiB
Markdown
144 lines
3.1 KiB
Markdown
# 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
|