徐总
9cce1e76fc
- 基于 Electron + React 的跨平台桌面应用 - 支持多 Bot ID 和 Secret 配置 - 双 WebSocket 长连接（企业微信 + OpenClaw Gateway） - 图形化配置界面，实时连接状态显示 - 自动重连机制 - 支持 Windows/macOS/Linux 打包 技术栈: - Electron 28 - React 18 - @wecom/aibot-node-sdk - electron-store 配置持久化
4.3 KiB
4.3 KiB
WeCom OpenClaw Client
企业微信智能机器人图形配置客户端 - 基于 Electron 的跨平台桌面应用
功能特性
- ✅ 图形化配置界面 - 直观的 UI 配置 Bot ID 和 Secret
- ✅ 多 Bot 支持 - 支持配置多个企业微信智能机器人
- ✅ 双 WebSocket 长连接
- 企业微信 WebSocket (wss://openws.work.weixin.qq.com)
- OpenClaw Gateway WebSocket
- ✅ 跨平台 - 支持 Windows、macOS、Linux
- ✅ 自动重连 - 断线自动重连机制
- ✅ 实时日志 - 连接状态和消息日志实时显示
技术栈
- Electron - 跨平台桌面应用框架
- React - 前端 UI 框架
- @wecom/aibot-node-sdk - 企业微信智能机器人 SDK
- ws - WebSocket 客户端
- electron-store - 配置持久化存储
快速开始
1. 克隆项目
git clone http://192.168.1.191:23000/toncent/wecome-openclaw-client.git
cd wecome-openclaw-client
2. 安装依赖
# 安装主项目依赖
npm install
# 安装渲染进程依赖
cd renderer
npm install
cd ..
3. 开发模式运行
npm start
应用会在开发模式下启动，自动打开窗口并支持热重载。
4. 构建发布版本
# 构建所有平台
npm run build
# 仅构建 Windows
npm run dist:win
# 仅构建 macOS
npm run dist:mac
# 仅构建 Linux
npm run dist:linux
构建产物在 dist/ 目录。
配置说明
企业微信机器人配置
- 登录 企业微信管理后台
- 进入「应用管理」->「智能机器人」
- 创建或选择机器人，开启「API 模式」并选择「长连接」
- 获取 BotID 和 Secret
- 在客户端中添加机器人配置
OpenClaw Gateway 配置
- 默认地址:
ws://localhost:18789 - Token: 如果 Gateway 启用了认证，需要填写 Token
- Token 可在
~/.openclaw/openclaw.json中配置
项目结构
wecome-openclaw-client/
├── electron/ # Electron 主进程
│ ├── main.js # 主进程入口
│ └── preload.js # 预加载脚本
├── renderer/ # React 渲染进程
│ ├── public/
│ │ └── index.html
│ └── src/
│ ├── App.js # 主组件
│ ├── index.js # 入口文件
│ └── index.css # 样式
├── resources/ # 应用资源（图标等）
├── package.json
└── README.md
WebSocket 协议
企业微信长连接
- 连接地址：
wss://openws.work.weixin.qq.com - 订阅命令：
aibot_subscribe - 心跳间隔：30 秒
- 文档：https://developer.work.weixin.qq.com/document/path/101463
OpenClaw Gateway 协议
- 连接地址：
ws://localhost:18789(可配置) - 协议版本：3
- 角色：operator
- 文档：https://docs.openclaw.ai/zh-CN/gateway/protocol
开发指南
添加新功能
- 主进程功能 - 在
electron/main.js中添加 IPC 处理器 - 渲染进程 UI - 在
renderer/src/App.js中添加组件 - IPC 通信 - 在
electron/preload.js中暴露 API
调试
开发模式下会自动打开 DevTools，可以：
- 查看 Console 日志
- 调试 React 组件
- 监控网络请求
打包配置
在 package.json 的 build 字段配置：
- 应用信息（名称、ID 等）
- 各平台打包选项
- 文件包含规则
常见问题
Q: 连接企业微信失败？
A: 检查 BotID 和 Secret 是否正确，确保在企业微信后台开启了长连接模式。
Q: OpenClaw 连接失败？
A: 确保 OpenClaw Gateway 已启动 (openclaw gateway start)，检查地址和 Token。
Q: 配置保存在哪里？
A: 配置保存在系统标准位置：
- Windows:
%APPDATA%\wecome-openclaw-client\config.json - macOS:
~/Library/Application Support/wecome-openclaw-client/config.json - Linux:
~/.config/wecome-openclaw-client/config.json
更新日志
v1.0.0 (2026-03-09)
- 初始版本发布
- 支持多 Bot 配置
- 双 WebSocket 长连接
- 跨平台支持
许可证
MIT License