ClawBotGui - 微信聊天客户端

一个基于 @tencent-weixin/openclaw-weixin 的微信聊天桌面客户端(就是你的ClawBot本体)，支持收发文本、图片、语音、视频和文件消息。

功能特性

• 扫码登录：使用微信扫一扫快速登录
• 消息收发：支持文本、图片、语音、视频、文件等多种消息类型
• 多媒体支持：
  • 图片：自动下载解密，右键保存/复制
  • 语音：自动转码播放
  • 视频：在线播放
  • 文件：双击打开或另存为
• 会话管理：自动聚合联系人会话列表
• 消息缓存：多媒体文件本地缓存，加速重复查看
• 跨平台：支持 Windows、macOS 和 Linux

技术栈

• Electron - 桌面应用框架
• WeChat C2C API - 微信消息接口
• AES-ECB - 消息加密解密
• 自定义协议 - app-media:// 协议安全加载本地文件

安装运行

开发环境

# 安装依赖
pnpm install

# 启动开发模式
npm start

打包构建

# Windows
npm run electron:build:win

# macOS
npm run electron:build:mac

# Linux
npm run electron:build:linux

# 全平台
npm run electron:build

项目结构

openclaw-weixin/
├── main.js              # 主进程代码
├── preload.js           # 预加载脚本
├── package.json         # 项目配置
├── assets/              # 图标资源
│   ├── icon.png
│   ├── icon.ico
│   └── icon.icns
├── renderer/            # 渲染进程
│   ├── index.html       # 主页面
│   ├── app.js           # 前端逻辑
│   └── style.css        # 样式文件
├── scripts/             # 构建脚本
│   └── cleanup-after-pack.js
├── docs/                # 文档图片
│   └── demo.png
└── dist/                # 打包输出目录

配置说明

Token 存储

登录 Token 存储在用户数据目录：

• Windows: %APPDATA%\ClawBotGui\.weixin-token.json
• macOS: ~/Library/Application Support/ClawBotGui/.weixin-token.json
• Linux: ~/.config/ClawBotGui/.weixin-token.json

缓存文件

多媒体文件缓存目录：%TEMP%\weixin-chat-images

注意事项

1. 打包时会自动清理 Electron 的多语言文件，仅保留中文
2. 程序需要联网访问微信 C2C API
3. 首次登录需要微信扫码授权

License

MIT