Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
104 lines (91 loc) · 7.14 KB

ARCHITECTURE.md

File metadata and controls

104 lines (91 loc) · 7.14 KB
Raw

首页 · 使用指南 · 常见问题 · 配置参数 · 架构 · 安全 · 多 Agent · 多渠道 · 命令

架构与对比

和其他方案的对比

飞书 Telegram WhatsApp 本插件
中国区可用 ✅ ❌ 需VPN ❌ 需外国号 ✅
配置复杂度 🔴 高（企业账号） 🔴 高（VPN） 🔴 高 🟢 一条命令
AI 独立空间 ❌ 混在工作消息中 ❌ 混在社交中 ❌ 混在社交中 ✅ 专属 AI App
独立推送 ❌ 和工作混在一起 ❌ 被社交淹没 ❌ 被社交淹没 ✅ 独立通知
数据隐私 🟡 经飞书服务器 🟡 经 TG 服务器 🟡 经 Meta 服务器 🟢 完全本地
多 Agent 需手动配置 支持 支持 ✅ 交互式配置
群组多机器人 有限 支持 不支持 ✅ 支持
多人团队共享 需企业版 ❌ 各用各的 ❌ 各用各的 ✅ 一套服务全员用
权限管理 需企业版 ❌ ❌ ✅ 全功能/只读
分离部署 ❌ ❌ ❌ ✅ 内网也能用
自托管 ❌ ❌ ❌ ✅
免费 有限制 是 是 ✅ 完全免费
开源 ❌ ❌ ❌ ✅ MIT

架构图

方式 A：同机部署

所有组件在同一台服务器上，最简单。

┌─────────────────────────────────────────────┐
│              📱 用户手机                      │
│           Rocket.Chat App                    │
└─────────────┬───────────────────────────────┘
              │ HTTPS (:443)
┌─────────────▼───────────────────────────────┐
│         你的公网服务器（一台机器搞定）          │
│                                              │
│  ┌──────────────────────────────────────┐   │
│  │  Docker                               │   │
│  │  ┌───────┐  ┌──────────┐  ┌───────┐  │   │
│  │  │ Nginx │─▸│Rocket.Chat│─▸│MongoDB│  │   │
│  │  │ :443  │  │  :3000   │  │       │  │   │
│  │  │(HTTPS)│  │ (内部)    │  │       │  │   │
│  │  └───────┘  └──────────┘  └───────┘  │   │
│  └──────────────────────────────────────┘   │
│                                              │
│  ┌──────────────────────────────────────┐   │
│  │  OpenClaw Gateway                     │   │
│  │  @openclaw/rocketchat plugin          │   │
│  │  ┌─────────────┐                     │   │
│  │  │ Agent: main │                     │   │
│  │  │ Agent: work │                     │   │
│  │  └─────────────┘                     │   │
│  └──────────────────────────────────────┘   │
└──────────────────────────────────────────────┘

方式 B：分离部署

RC 在公网 VPS，OpenClaw 在家庭内网或低配机器。适合没有公网 IP 或内存不足的场景。

┌─────────────────────────────────────────────┐
│              📱 用户手机                      │
│           Rocket.Chat App                    │
└─────────────┬───────────────────────────────┘
              │ HTTPS (:443)
┌─────────────▼───────────────────────────────┐
│       公网 VPS（便宜的小鸡即可，1C1G 够用）    │
│                                              │
│  ┌──────────────────────────────────────┐   │
│  │  Docker（install-rc.sh 一键安装）      │   │
│  │  ┌───────┐  ┌──────────┐  ┌───────┐  │   │
│  │  │ Nginx │─▸│Rocket.Chat│─▸│MongoDB│  │   │
│  │  │ :443  │  │  :3000   │  │       │  │   │
│  │  │(HTTPS)│  │ (内部)    │  │       │  │   │
│  │  └───────┘  └─────▲────┘  └───────┘  │   │
│  └───────────────────┼──────────────────┘   │
└──────────────────────┼───────────────────────┘
                       │ HTTPS/WebSocket (公网)
┌──────────────────────┼───────────────────────┐
│       家庭内网 / 本地电脑                      │
│                      │                        │
│  ┌───────────────────┴──────────────────┐    │
│  │  OpenClaw Gateway                     │    │
│  │  @openclaw/rocketchat plugin          │    │
│  │  （通过公网连接远程 RC）                │    │
│  │  ┌─────────────┐                      │    │
│  │  │ Agent: main │                      │    │
│  │  │ Agent: work │                      │    │
│  │  └─────────────┘                      │    │
│  └───────────────────────────────────────┘    │
└───────────────────────────────────────────────┘

方式 B 中，远程 VPS 上只需运行 install-rc.sh 脚本即可安装 Rocket.Chat（含 Nginx HTTPS），然后回到本地 OpenClaw 运行 openclaw rocketchat setup 输入 https://公网IP。

技术栈

  • TypeScript — 与 OpenClaw 生态一致
  • Rocket.Chat REST API — 用户/群组/消息管理
  • Rocket.Chat WebSocket (DDP) — 实时消息订阅
  • Docker Compose — 一键部署 Rocket.Chat + MongoDB
  • Vitest — 单元测试