OpenClaw 的整体架构可以用"一个网关 + 多个智能体 + 可扩展技能 + 本地记忆文件"来概括,采用以 Gateway(网关)为核心的星型(Hub-and-Spoke)架构模式。
下面逐一介绍四大核心模块:
Gateway 是 OpenClaw 最常驻的后台进程(默认运行在 127.0.0.1:18789),负责:
所有外部交互(消息平台、CLI 工具、Web 界面、节点设备)都通过 WebSocket 协议 与 Gateway 通信,Gateway 是整个系统唯一对外暴露的控制平面。
Agent 是真正调用大模型进行推理、决策并执行任务的模块。每个 Agent 拥有独立的:
Agent 的核心工作循环(Agentic Loop)如下:
Skills 是 Agent 能力的扩展机制。每个 Skill 以文件夹形式存在,核心文件是 SKILL.md,用自然语言描述"遇到某类任务时应该怎么做"。当 Agent 在推理过程中识别到任务与某个 Skill 匹配时,会读取对应的 SKILL.md 来获取执行指引。
Skills 支持多层嵌套——一个 Skill 可以调用另一个 Skill,形成复杂的工作流编排能力。
Memory 模块负责将所有重要信息以 Markdown 文件形式持久化到本地磁盘。如前文所述,它包括 MEMORY.md(长期记忆)、memory/YYYY-MM-DD.md(每日日志)等多层结构,并通过混合检索机制在每次会话开始时将相关信息加载到模型上下文中。
架构总览图(文字描述)
消息平台(WhatsApp/Telegram/企业微信...)
│
▼
Gateway(网关,WebSocket,端口18789)
│
▼
Agent(智能体,调用大模型推理)
│
├──► Skills(技能包,扩展能力)
│
└──► Memory(记忆文件,Markdown持久化)