RCBridge 是一个 Windows 桌面桥接工具:通过 WeRC 接收微信消息,将其转发给 OneBot v11 应用,并把机器人的回复发回微信。它不自带机器人、模型或微信客户端。
| 项目 | 支持范围 |
|---|---|
| 桌面端 | Windows x64,需 Microsoft Edge WebView2 Runtime。便携包自带 Python 和桥接依赖,不包含微信、WeRC 或 AstrBot。 |
| 微信接入 | 推荐用 WeRC:接收原生入站消息,支持发送文本、图片、文件、视频和语音(取决于 WeRC 接受的格式和授权范围)。也可配置 Alpha 或 WeFlow 为接收源,或选择 Windows UIA 发送;这些是独立的接入路径,能力不完全相同。 |
| 机器人接入 | OneBot v11 反向 WebSocket:RCBridge 主动连接下游应用提供的地址。通用模式不依赖 AstrBot;配置 AstrBot 后可使用其成员权限同步和重启功能。 |
新版 WeRC 的「Bot 收发」令牌默认包含群名同步、好友列表和分类通讯录,无需分别勾选。「成员与权限」可查看名称和 OneBot ID,并按类别浏览通讯录。数据来自 WeRC 本地缓存,不代表微信服务器的实时全量名单。
- 从 Releases 下载 Windows x64 便携包。完整解压,运行顶层的
RCBridge.exe。 - 在已连接微信的 WeRC 中复制「Bot 接入」配置,在 RCBridge 的「连接设置」中导入,然后填写 OneBot v11 反向 WebSocket 地址及所需令牌。
- 保存后关闭并重新打开 RCBridge,点击「启动桥接」。在总览确认两端已连接,再用测试联系人验证实际收发。
RCBridge is a Windows desktop bridge. It receives WeChat messages through WeRC, forwards them to a OneBot v11 app, and sends the bot's replies back to WeChat. It does not provide a bot, model, or WeChat client.
| Area | Support |
|---|---|
| Desktop | Windows x64 with Microsoft Edge WebView2 Runtime. The portable package includes Python and bridge dependencies, but not WeChat, WeRC, or AstrBot. |
| WeRC is recommended for native inbound messages and sending text, images, files, video, and audio, subject to WeRC permissions and accepted formats. Alpha and WeFlow are alternative receive sources, and Windows UI Automation is an alternative send method. These paths have different capabilities. | |
| Bots | OneBot v11 over reverse WebSocket: RCBridge connects to the endpoint exposed by the downstream app. AstrBot is optional and enables additional member-permission sync and restart controls when configured. |
The newer WeRC Bot preset includes group-name sync, the friend list, and the categorized directory in one token. People shows names alongside OneBot IDs and lets you browse the directory by category. The directory reflects WeRC’s local cache, not live server relationships.
- Download the Windows x64 portable ZIP from Releases. Extract the entire ZIP and run
RCBridge.exeat the top level. - In WeRC, connect WeChat and copy the bot connection settings. Import them in RCBridge's Connection Settings, then enter the OneBot v11 reverse WebSocket URL and any required token.
- Save, close and reopen RCBridge, then start the bridge. Check that both connections are up and verify message delivery with a test contact.
Usage and troubleshooting (Chinese) · Changelog (Chinese) · License
在 Windows x64 上使用 64 位 CPython 3.13 和 .NET Framework 4.x 的 x64 C# 编译器。在项目根目录用 PowerShell 执行;输出目录须不存在。
On Windows x64, use 64-bit CPython 3.13 and the x64 .NET Framework 4.x C# compiler. Run in PowerShell from the repository root; the output directory must not already exist.
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-lock.txt
.\.venv\Scripts\python.exe -X utf8 -m unittest discover -s tests
.\.venv\Scripts\python.exe -X utf8 build_desktop.py build/RCBridge-win-x64
.\.venv\Scripts\python.exe -X utf8 tests/offline_roundtrip.py build/RCBridge-win-x64