Agent 消息路由网关 vb2250158/RabiRoute

RabiRoute

RabiRoute 吉祥物，把通信、智能设备与桌面自动化连接到智能体

让智能体连接身边的一切。

把通信平台、智能设备与桌面工作流接到合适的智能体上。

RabiRoute 是自托管的消息网关与策略路由器，面向 AI 智能体。把聊天、桌面事件和智能设备接到你正在用的智能体上，附带角色上下文、定时任务和结果记录。

RabiRoute 负责连接与路由。模型、工具和执行都归你的智能体。

概览 · 快速开始 · 架构 · 文档 · 社区

能连接什么

flowchart LR
C["ChatQQ · WeChat · WeCom · Feishu"] --> R["RabiRouteRoutes + role context"]
T["SchedulesWebhooks"] --> R
I["DesktopDevice events"] --> R
R --> A["Your AgentCodex · DSH · WorkBuddy"]
A --> O["Reply or actionSending rules + receipts"]
classDef input fill:#e8f2ff,stroke:#4777b7,color:#162b48
classDef router fill:#dcf5ed,stroke:#218468,color:#113d31
classDef agent fill:#f0e7fa,stroke:#8254a8,color:#372044
classDef output fill:#fff0df,stroke:#bf7b30,color:#51351c
class C,T,I input
class R router
class A agent
class O output

QQ 和 Codex Desktop 的核心链路已经验证。其他适配器和物理设备集成各有成熟度与配置要求，见集成状态。

| 你想做什么 | 从这里开始 |
| 从 QQ、微信、企业微信或飞书向智能体提问 | 选择消息输入 |
| 按定时或 webhook 运行任务 | 第一条路由 |
| 把角色上下文、计划、记忆和技能放在一起 | 角色与规则 |
| 发送选中文本、截图、语音或设备事件 | 桌面端与客户端指南 |

从消息到结果

Route 负责选定角色、Agent 任务、工作区和回复规则。下图展示一次由聊天触发的运行；定时任务使用各自配置的目标。发送回复仍是独立动作，并会留下记录。

sequenceDiagram
participant S as Chat or device
participant R as RabiRoute
participant A as Existing Agent task
S->>R: Message
R->>R: Match Route and attach recent context
R->>A: Deliver to selected task and workspace
A-->>R: Result or completion callback
R->>R: Apply sending rules and record receipt
R-->>S: Reply when the sending rule allows

快速开始

| 你需要什么 | 入口 |
| 主应用 —— Manager、WebGUI 和 Windows 桌面端 | Windows 安装/构建指南 · 源码启动 |
| 另一台电脑，连接到你的主应用 | 连接电脑 |
| Linux 浏览器界面 | Linux Host |

从主应用连接另一台电脑： 生成安装提示词，让目标电脑上的 Agent 执行它。提示词会从你的 Manager 下载并校验一个轻量连接器，无需单独的 GitHub 安装包。目标电脑需要 Node.js 22.13+、npm，并能访问 Manager 地址。平台要求见 PC 接入。

flowchart LR
P["Main appCopy installation prompt"] --> T["Target computerExecute the prompt"]
T --> V["Verify signatureInstall connector"]
V --> C["Computer connectsCheck version and digest"]

历史 Windows 下载

发布历史 中包含旧版主应用和独立 Remote Agent 包。RabiRoute-Remote-Agent-… 安装包不会安装主应用。当前源码使用 Host 托管的启动方式；请按上面的源码/构建指南操作，不要以为 GitHub 上最新的 Release 就是当前主应用。

1. 启动主应用，从托盘或 Host 提供的地址打开 WebGUI。
2. 选择一个角色。添加消息 Route，并绑定它的 Agent、已有任务和工作区。
3. 使用 Channel check → Delivery test。确认原 Agent 会话收到消息，且投递记录显示结果。

投递测试会发送真实消息。前置条件和恢复方法见 第一条 Route 演练。

从源码运行 Windows： 已经装过 RabiRoute，并且有 Node.js/npm 和 .NET 9 SDK，直接运行 Start-RabiRoute-FromSource.bat。它会构建，并通过 Host 切换已安装的应用，数据保留。首次安装，或运行时依赖有变化，请按完整打包指南操作。

Linux： 先装 Node.js 22.13+、npm 和 util-linux 的 flock，然后：

git clone https://github.com/vb2250158/RabiRoute.git
cd RabiRoute
bash Start-RabiRoute-FromSource.sh
npm run status:linux -- --json

打开 Host 返回的地址。Linux Host 仍是实验性功能，不提供 Windows 托盘、截图和全局热键。参见启动与日志。

集成状态

仓库版本为 0.4.4。

| 领域 | 当前范围 |
| QQ / NapCat / OneBot + Codex Desktop | 核心投递链路已验证 |
| 路由、日程、WebGUI、角色方案和记忆 | 核心链路已验证 |
| Windows 桌面 | 核心功能已实现；系统交互需在设备上验收 |
| 个人微信（Weixin）、企业微信和飞书 | 原型 / 实验性；真实账号验收情况不一 |
| DSH、WorkBuddy、Grok Bot 和远程电脑客户端 | 实验性；需逐个验证后端和目标电脑 |
| Linux Host、RabiSpeech、手机、眼镜、可穿戴设备和 Home Assistant | 实验性；模型、网络和硬件需分别验收 |

完整能力矩阵 · 变更与迁移

架构

Windows 安装包用一个 Host 统一管理 Manager 和桌面界面。Manager 负责路由和业务状态；插件提供适配器和服务。智能体任务和可选的语音/设备服务各自维护生命周期。

flowchart TB
H["Windows Host"] --> M["Manager"]
H --> W["Desktop / tray"]
U["Browser / WebGUI"] <--> M
W <--> M
M --> K["Plugin Kernel"]
K --> P["Message adaptersRoutes · plans · memory"]
P <--> D[("Private local data")]
P <--> A["External Agent tasks"]
P <--> S["Optional speechand device services"]

数据、执行与隐私

- 每个角色把自己的指引和设置放在 data/roles/<RoleId>/；路由配置放在 data/route/ 下。可复制的公开样例见 examples/data。
- 目标智能体自己管理模型、工具、沙箱和审批。Codex 的消息投递使用选定的 Desktop 任务负责人。
- 平台凭据、录音、私信和运行时数据都属于私有运营数据，不要放进公开仓库。
- 手机、眼镜、可穿戴设备和远程电脑工作流，都要在真实环境中验收。参见架构和插件包。

文档

| 我想…… | 指南 |
| 完成第一个任务 | 第一条路由 · 用户指南 |
| 查看状态或排查故障 | 界面与状态 · 运维 |
| 接入语音、设备或另一台电脑 | 客户端应用 · RabiSpeech · 家庭设备 · PC 接入 |
| 集成或扩展 RabiRoute | API 发现 · 架构 · 功能地图 |
| 浏览全部文档 | 文档索引 · 配置 |

社区

加入 QQ 群 Rabi的信件整理站：1130935416。分享配置、提问、讨论 RabiRoute。用手机 QQ 扫码，或搜索群号。点击卡片可打开完整尺寸的二维码。

RabiRoute 社区卡片 — QQ 群 1130935416

许可证

MIT License。