徐总
fddd2b2e6b
新增功能: - OpenClaw Gateway 配置支持修改保存（地址和 Token） - 新增测试消息通信功能，可发送测试消息验证 Gateway 连接 - 添加 URL 清理按钮（移除末尾斜杠） - 界面显示版本号 v1.0.0-fix7 修复: - OpenClaw WebSocket 握手协议（等待 challenge 响应） - 关闭窗口时事件处理器访问已销毁窗口的错误 - SSL/TLS 错误诊断和提示 - 连接状态管理优化 技术改进: - 使用 challenge-response 握手机制连接 OpenClaw Gateway - 添加窗口销毁检查避免事件发送失败 - 改进错误日志和诊断信息 - 优化连接状态更新逻辑
3.1 KiB
3.1 KiB
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 系统
-
下载和解压
解压 WeCom-OpenClaw-Client-v1.0.0-win64.zip -
运行程序
双击 "WeCom OpenClaw Client.exe" -
配置机器人
- 点击"添加机器人"
- 输入 Bot ID 和 Secret（从企业微信管理后台获取）
- 点击"连接"
-
配置 OpenClaw Gateway
- 默认地址：
ws://localhost:18789 - 如果启用了 Token 认证，填写 Token
- 点击"连接 OpenClaw"
- 默认地址：
-
测试
- 在企业微信中给机器人发送消息
- 查看日志控制台确认消息转发
- AI 回复会自动发送回企业微信
🔧 技术架构
双 WebSocket 长连接
企业微信用户 <---> 企业微信 WebSocket <---> 本客户端 <---> OpenClaw Gateway <---> AI 智能体
(云端) (本地) (本地)
消息转发流程
企业微信 → OpenClaw
- 用户在企业微信发送消息
- 企业微信 WebSocket 推送消息到客户端
- 客户端提取文本、媒体、引用等内容
- 构建 OpenClaw 消息格式并转发
- OpenClaw 路由到 AI 智能体处理
OpenClaw → 企业微信
- AI 智能体生成回复
- OpenClaw 通过 WebSocket 推送回复
- 客户端接收回复消息
- 使用流式消息发送到企业微信
- 用户看到 AI 回复
心跳保活
- 企业微信：30 秒/次
- OpenClaw：15 秒/次
- 自动重连：指数退避（最大 100 次）
🛠️ 重新构建
如果需要重新构建：
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 正确
消息不转发
- 检查两个连接是否都已建立（绿色状态指示器）
- 查看日志控制台是否有消息记录
- 确认企业微信机器人已正确配置
📞 技术支持
构建时间: 2026-03-09
版本: 1.0.0
平台: Windows 64-bit