Files

- 新增 messageStore.js 消息存储模块，支持自动保存所有收发消息
- 修改 main.js，在消息转发时自动记录到本地存储
- 修改 preload.js，暴露消息管理 IPC API
- 修改 App.js，添加消息历史查看界面
  - 统计信息面板（总数/接收/发送/会话数）
  - 会话列表和消息详情
  - 搜索、过滤、分页功能
  - 导出 JSON 和清空历史
- 新增完整文档（MESSAGE_HISTORY.md 等）
- 新增测试脚本 test-message-history.js

版本：v1.0.1

2026-03-10 04:09:26 +08:00

4.3 KiB

Raw Blame History

构建和运行指南

快速开始

1. 安装依赖

cd ~/.openclaw/workspace/wecome-openclaw-client

# 安装主项目依赖
npm install

# 安装渲染进程依赖
cd renderer
npm install
cd ..

2. 开发模式运行

npm start

应用会自动打开，支持热重载。

3. 测试消息历史功能

node test-message-history.js

构建发布版本

构建所有平台

npm run build

仅构建特定平台

# Windows
npm run dist:win

# macOS
npm run dist:mac

# Linux
npm run dist:linux

构建产物在 dist/ 目录。

功能验证

1. 启动应用后，检查以下内容：

✅ OpenClaw Gateway 配置区域正常显示
✅ 企业微信机器人配置区域正常显示
✅ 右上角有 💬 消息历史 按钮
✅ 实时日志区域正常显示

2. 测试消息历史功能：

点击 💬 消息历史 按钮
查看统计信息面板（显示总消息数、接收数、发送数、会话数）
查看左侧会话列表
查看右侧消息列表
测试搜索功能
测试过滤功能
测试分页功能

3. 测试消息保存：

在企业微信中发送一条消息
等待 OpenClaw 回复
打开消息历史，查看是否保存了两条消息
验证消息内容、时间、方向是否正确

配置企业微信机器人

登录企业微信管理后台
进入「应用管理」->「智能机器人」
创建或选择机器人，开启「API 模式」并选择「长连接」
获取 BotID 和 Secret
在客户端中点击「+ 添加机器人」
填写 BotID、Secret 和名称
点击「连接」

配置 OpenClaw Gateway

确保 OpenClaw Gateway 已启动：
```
openclaw gateway status
```
在客户端中配置 Gateway 地址：
- 默认：ws://localhost:18789
- 远程：wss://your-server.com
如果启用了 Token 认证，填写 Token
点击「连接 OpenClaw」

常见问题

Q: 应用启动失败？

A: 检查 Node.js 版本（建议 v18+），重新安装依赖：

rm -rf node_modules renderer/node_modules
npm install
cd renderer && npm install && cd ..

Q: 消息历史按钮点击无反应？

A: 打开开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），查看 Console 是否有错误信息。

Q: 消息没有保存？

A: 检查：

OpenClaw 是否已连接
企业微信机器人是否已连接
查看实时日志，确认消息是否正常转发
检查存储目录权限：~/.config/wecome-openclaw-client/messages/

Q: 导出 JSON 失败？

A: 确保浏览器允许下载文件，或检查是否有足够磁盘空间。

Q: 搜索功能不工作？

A: 确保输入了搜索关键词并按回车或点击搜索按钮。

目录结构

wecome-openclaw-client/
├── electron/                    # Electron 主进程
│   ├── main.js                 # 主进程入口（已修改）
│   ├── preload.js              # 预加载脚本（已修改）
│   └── messageStore.js         # 消息存储模块（新增）
├── renderer/                   # React 渲染进程
│   └── src/
│       ├── App.js              # 主组件（已修改）
│       ├── index.js            # 入口文件
│       └── index.css           # 样式
├── resources/                  # 应用资源
├── test-message-history.js     # 测试脚本（新增）
├── MESSAGE_HISTORY.md          # 功能说明（新增）
├── CHANGELOG_MESSAGE_HISTORY.md # 更新日志（新增）
├── BUILD_AND_RUN.md            # 本文档（新增）
├── package.json
└── README.md

技术栈

Electron: 28.0.0
React: 18.2.0
@wecom/aibot-node-sdk: 企业微信 SDK
ws: WebSocket 客户端
electron-store: 配置存储

系统要求

操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+)
Node.js: v18.0.0+
内存: 最少 512MB
磁盘: 最少 200MB（不含消息存储）

下一步

应用启动并配置完成后：

✅ 配置企业微信机器人
✅ 连接 OpenClaw Gateway
✅ 测试消息收发
✅ 查看消息历史
✅ 导出备份数据

祝你使用愉快！🎉

4.3 KiB Raw Blame History Unescape Escape