赛博帝国 AI 总控台架构说明书 v2.0
发布日期： 2026-04-22 维护者： 内阁首辅 状态： 生产环境
一、架构概述
本架构旨在构建一个分层明确、职责清晰、高可用的私人 AI 操作系统，以 OpenWebUI 为总控台界面，Hermes 为总调度器，OpenClaw 和 QwenPaw 为双执行核心，cliproxyapi 为统一模型网关（x86+ARM 双机热备）。
核心设计原则
- 分层明确 - 不扁平化，各层职责清晰
- 渠道收敛 - 避免渠道爆炸，内部 Agent 不直连外部
- 模型高可用 - cliproxyapi 双机热备，改 IP 分钟级恢复
- 双轨记忆 - OpenWebUI 知识库 + OpenClaw 工作区记忆，各管各的
二、组件职责
2.1 OpenWebUI（总控台界面）
部署位置： 飞牛容器 职责：
- 用户交互入口（聊天、文件上传、模型切换）
- 知识库管理（RAG 文档检索）
- 模型切换台（通过 cliproxyapi 切换后端模型）
- 任务模式选择（对话模式/研究模式/调度模式/执行模式）
- 系统状态可视化（服务健康检查面板）
2.2 Hermes（总调度器）
部署位置： 虚拟机 职责：
- 任务理解与解析
- 任务拆分与编排
- 任务下发（OpenClaw / QwenPaw / 其他 Agent）
- 跨执行器协调
- 任务状态追踪
2.3 OpenClaw main（执行中枢）
部署位置： 虚拟机（独立部署） 职责：
- 接收 Hermes 下发任务
- 执行本机/工作区相关任务
- 调度内部三部（户部/工部/礼部）
- 维护长期记忆（MEMORY.md + workspace）
- 工作日志留痕
- 企业微信渠道接入（三条单线）
2.4 cliproxyapi（模型网关）⭐ 高可用核心
部署位置： x86 飞牛 + ARM 飞牛（双机热备） 职责：
- 统一接入云端模型 API
- 本地模型分发
- 模型路由与别名管理
- 降级策略（模型故障时自动切换）
高可用方案：
- x86 飞牛 + ARM 飞牛 双机部署
- 数据同步
- 单点故障 → 改 IP → 分钟级恢复
- 健康检查 + 自动告警
三、调度层级
Level 0: 用户入口（OpenWebUI / 企业微信）
↓
Level 1: Hermes（总调度器）
↓
Level 2: 执行中枢（OpenClaw main / QwenPaw）
↓
Level 3: 内部子 Agent（三部）
调度规则
| 任务类型 | 路由路径 |
|---|---|
| 普通聊天问答 | OpenWebUI → cliproxyapi → 模型 |
| 复杂多步骤任务 | OpenWebUI → Hermes → OpenClaw/QwenPaw |
| 金融数据分析 | Hermes → OpenClaw → 户部 |
| 技术开发运维 | Hermes → OpenClaw → 工部 |
| 内容发布编辑 | Hermes → OpenClaw → 礼部 |
| 强推理任务 | Hermes → QwenPaw |
四、记忆与知识双轨制
4.1 OpenWebUI 知识库
用途： 文档检索、项目资料、手册、外部知识沉淀 存储： 向量数据库 + 文档索引
4.2 OpenClaw 工作区记忆
用途： 决策记录、工作留痕、Agent 协作上下文、帝国内部长期记忆 存储：
- MEMORY.md - 长期记忆索引
- memory/YYYY-MM-DD.md - 日常日志
- .learnings/ - 经验教训
五、高可用方案（v2.0 修订）
5.1 cliproxyapi 双机热备（核心）
| 组件 | x86 飞牛 | ARM 飞牛 |
|---|---|---|
| cliproxyapi | ✅ | ✅ |
| 数据同步 | ✅ | ✅ |
| 主用 IP | 动态切换 | 动态切换 |
恢复策略：
- x86 故障 → 改 IP 到 ARM
- ARM 故障 → 改 IP 到 x86
- 分钟级恢复
六、演进路线
Phase 1：总控台可用（当前）
- ✅ OpenWebUI 接 Hermes
- ✅ 模型切换稳定
- ✅ 知识库可用
- ✅ 各执行器在线可见
Phase 2：总控台可管（进行中）
- Hermes 任务看板
- OpenClaw / QwenPaw 状态展示
- 故障切换手册
Phase 3：总控台可编排（规划中）
- 从 OpenWebUI 一键发起 Hermes 编排任务
- 执行结果回流
- 任务日志可追踪
Phase 4：总控台可治理（规划中）
- 权限分级
- 审计日志
- 任务归档
- 资源和成本统计
最后更新： 2026-04-22 22:20 维护者： 内阁首辅