Cygnus Tech Blog
Cygnus Tech Blog

第02章 核心架构总览 —— Gateway 为什么是中心控制平面

Cygnus Yang 收录于 01-AI 工具与智能体/01-OpenClaw
 约 600 字 预计阅读 3 分钟 

上一章我们介绍了 OpenClaw 是什么。本章我们来看整体架构，理解 Gateway 为什么是中心控制平面。

设计目标

OpenClaw 架构设计要解决几个问题：

  1. 多渠道接入：用户可以从任何聊天平台发来消息，Gateway 都能处理
  2. 多模型支持：用户可以用 Anthropic/O纸张的厚度实在太薄，所以这一步对接画人员的要求penAI/Google 任意模型，随时切换
  3. 多智能体协作：支持一个任务拆给多个智能体分工完成
  4. 可扩展：方便添加新的渠道、新的技能、新的工具
  5. 安全隔离：未认证用户不能访问，数据不出去

整体架构图

图表 代码
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  subgraph "Clients"
    C1[Chat Channel
WhatsApp/Telegram/Discord]
    C2[CLI
Command Line]
    C3[WebChat UI
Browser]
    C4[Native App
macOS/iOS/Android]
  end

  G[Gateway
ws://127.0.0.1:18789
中心控制平面]

  subgraph "Core Services"
    S1[Routing
消息路由]
    S2[Sessions
会话管理]
    S3[Agent Loop
AI 执行循环]
    S4[Tools
工具调用]
    S5[Skills
技能管理]
    S6[Security
安全认证]
  end

  subgraph "AI Models"
    M1[Anthropic Claude]
    M2[OpenAI GPT]
    M3[Google Gemini]
    M4[Other...]
  end

  C1 & C2 & C3 & C4 --> G
  G --> S1 & S2 & S3 & S4 & S5 & S6
  S3 --> M1 & M2 & M3 & M4
  M1 & M2 & M3 & M4 --> G
  G --> C1 & C2 & C3 & C4
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  subgraph "Clients"
    C1[Chat Channel
WhatsApp/Telegram/Discord]
    C2[CLI
Command Line]
    C3[WebChat UI
Browser]
    C4[Native App
macOS/iOS/Android]
  end

  G[Gateway
ws://127.0.0.1:18789
中心控制平面]

  subgraph "Core Services"
    S1[Routing
消息路由]
    S2[Sessions
会话管理]
    S3[Agent Loop
AI 执行循环]
    S4[Tools
工具调用]
    S5[Skills
技能管理]
    S6[Security
安全认证]
  end

  subgraph "AI Models"
    M1[Anthropic Claude]
    M2[OpenAI GPT]
    M3[Google Gemini]
    M4[Other...]
  end

  C1 & C2 & C3 & C4 --> G
  G --> S1 & S2 & S3 & S4 & S5 & S6
  S3 --> M1 & M2 & M3 & M4
  M1 & M2 & M3 & M4 --> G
  G --> C1 & C2 & C3 & C4
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  subgraph "Clients"
    C1[Chat Channel
WhatsApp/Telegram/Discord]
    C2[CLI
Command Line]
    C3[WebChat UI
Browser]
    C4[Native App
macOS/iOS/Android]
  end

  G[Gateway
ws://127.0.0.1:18789
中心控制平面]

  subgraph "Core Services"
    S1[Routing
消息路由]
    S2[Sessions
会话管理]
    S3[Agent Loop
AI 执行循环]
    S4[Tools
工具调用]
    S5[Skills
技能管理]
    S6[Security
安全认证]
  end

  subgraph "AI Models"
    M1[Anthropic Claude]
    M2[OpenAI GPT]
    M3[Google Gemini]
    M4[Other...]
  end

  C1 & C2 & C3 & C4 --> G
  G --> S1 & S2 & S3 & S4 & S5 & S6
  S3 --> M1 & M2 & M3 & M4
  M1 & M2 & M3 & M4 --> G
  G --> C1 & C2 & C3 & C4
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  subgraph "Clients"
    C1[Chat Channel<br/>WhatsApp/Telegram/Discord]
    C2[CLI<br/>Command Line]
    C3[WebChat UI<br/>Browser]
    C4[Native App<br/>macOS/iOS/Android]
  end

  G[Gateway<br/>ws://127.0.0.1:18789<br/>中心控制平面]

  subgraph "Core Services"
    S1[Routing<br/>消息路由]
    S2[Sessions<br/>会话管理]
    S3[Agent Loop<br/>AI 执行循环]
    S4[Tools<br/>工具调用]
    S5[Skills<br/>技能管理]
    S6[Security<br/>安全认证]
  end

  subgraph "AI Models"
    M1[Anthropic Claude]
    M2[OpenAI GPT]
    M3[Google Gemini]
    M4[Other...]
  end

  C1 & C2 & C3 & C4 --> G
  G --> S1 & S2 & S3 & S4 & S5 & S6
  S3 --> M1 & M2 & M3 & M4
  M1 & M2 & M3 & M4 --> G
  G --> C1 & C2 & C3 & C4

核心分层

OpenClaw 可以分为五层：

层职责举例
客户端接入层接收用户消息，返回结果Discord/Telegram 渠道、WebChat、原生 App
网关路由层消息路由、会话匹配把消息送到对应的会话
核心服务层会话管理、AI 循环、工具调用、技能管理
模型适配层对接不同 AI 模型 APIAnthropic/OpenAI/Google
扩展层技能、插件、工具浏览器、Cron、ClawHub 市场

Gateway 中心控制平面

Gateway 是中心，所有事情都经过 Gateway：

Gateway 做什么

  1. 接收：从各个客户端接收用户消息
  2. 路由：根据会话键，把消息送到正确的会话
  3. 执行：运行 AI 代理循环，调用模型，调用工具
  4. 返回：把结果返回给原始客户端
  5. 维护：会话生命周期管理、过期归档、资源回收

为什么要中心 Gateway

好处：

  • 统一认证：一次配置，所有渠道都能用
  • 统一配置：模型配置、技能配置、安全配置一处改到处生效
  • 统一日志：所有会话日志都存在一处，方便排查
  • 资源共享：连接池、缓存、模型配置共享，节省资源

关键设计决策

1. WebSocket 控制平面

Gateway 暴露 WebSocket 在 ws://127.0.0.1:18789，所有客户端都通过 WebSocket 连接上来。

好处：

  • 标准协议，各个平台都容易实现
  • 全双工，服务端可以主动推消息给客户端
  • 本地网络，延迟很低

2. 会话隔离

每个用户、每个对话都有独立会话：

  • 独立上下文
  • 独立配置
  • 独立存储

隔离带来健壮性，一个会话崩了不影响其他人。

3. 技能即插件

技能是 OpenClaw 扩展功能的方式：

  • 内置一些基础技能
  • ClawHub 社区分享技能
  • 你自己可以写私有技能

技能安装卸载不用改核心代码，很方便。

4. 安全默认安全

  • 默认拒绝所有未配对发送者
  • 需要你手动配对允许的用户/账号
  • 本地网关默认不对外开放
  • 数据永远不离开你的网络

重要设计原则

“本地优先”

  • 所有状态数据都存在你本地磁盘
  • 模型 API 调用是你的密钥，走你的网络
  • 可选远程模型，但默认本地掌控

“开箱即用”

  • 大部分常用渠道都内置了
  • 常用工具也内置了
  • 配置有合理默认值，你不用全懂就能跑起来

“保持开放”

  • 开源，完全自由使用
  • 接口开放，你可以扩展任何部分
  • 社区技能市场，共享成果

本章小结

  • OpenClaw 是中心 Gateway 架构，Gateway 是控制平面
  • 五层结构：客户端接入 → 网关路由 → 核心服务 → 模型适配 → 扩展
  • 设计原则：本地优先、开箱即用、保持开放
  • 下一章我们深入讲解 Gateway 核心，看它到底做了哪些事情

相关内容

收录于 合集・01-AI 工具与智能体/01-OpenClaw 34
更新于 2026-05-23 
CC BY-NC-SA 4.0
返回 | 主页
如果这篇文章对你有帮助，欢迎请我喝杯咖啡 ☕
Cygnus Yang 支付宝支付宝
Cygnus Yang 微信微信

目录