返回学习园地
第 2 / 8 课10 分钟阅读

架构解析:核心概念与记忆系统

深入 OpenClaw:运行时架构、关键抽象以及让智能体真正了解你的记忆系统。

目录

需要理解的前置概念

在开始动手操作之前,了解清楚这些概念更有利于更顺利的玩转 OpenClaw

OpenClaw 采用 "微核 + 插件 + 统一网关" 的架构模式,可以类比为一个"AI 操作系统"。

架构总览

WhatsApp / Telegram / Slack / Discord / 飞书 / ... / WebChat
                         │
                         ▼
            ┌──────────────────────┐
            │      Gateway         │
            │   (控制平面/中枢)    │
            │  ws://127.0.0.1:18789│
            └──────────┬───────────┘
                       │
           ┌───────────┼───────────┐
           │           │           │
       Pi Agent     CLI 工具    WebChat UI
       (RPC)     (openclaw...)   macOS App
                               iOS/Android

核心概念

Gateway(网关)

Gateway(网关) — OpenClaw screenshot
Gateway(网关) — OpenClaw screenshot

Gateway 是整个系统的心脏。

它负责管理所有连接、会话、配置、定时任务和 Webhook,但它自己不做 "思考" —— 思考交给 Agent。

把它理解为一个 "电话总机":所有渠道的消息进来,它负责转接给合适的 Agent 处理。

Channels(消息渠道适配器)

每个聊天平台都有一个独立的适配器,通过消息总线与 Agent 解耦。

Channels(消息渠道适配器) — OpenClaw screenshot
Channels(消息渠道适配器) — OpenClaw screenshot

你可以同时连接 WhatsApp、Telegram 和 Slack,在任何一个平台上跟你的 AI 助手对话,体验完全一致。

Hooks(扩展机制)

Hooks(扩展机制) — OpenClaw screenshot
Hooks(扩展机制) — OpenClaw screenshot

在 OpenClaw 的运行周期内,系统会不断产生各种生命周期事件(例如:系统启动、开启新会话 /new、触发特定工具、或是运行报错)。

Hooks 允许开发者预先埋入特定的逻辑,当这些系统事件发生时,自动“拦截”并触发执行。

CronJob(定时任务)

常规的 AI 助手通常是“被动响应式”的,必须依赖用户的 Prompt 唤醒才能工作。

CronJob(定时任务) — OpenClaw screenshot
CronJob(定时任务) — OpenClaw screenshot

通过配置时间调度规则,系统可以在特定的时间节点(如每天早晨 8 点)或按照固定的时间频率,在后台自动唤醒智能体去执行既定的工作流。

这意味着 OpenClaw 可以脱离人类的即时指令,独立完成周期性的数据巡检、生成汇总报告或定时信息推送,使其行为模式更接近一个具备一定自主性的“数字员工”。

四大核心概念的协同关系

Gateway 是整个系统的核心中枢,是所有组件的接入与调度中心;

Channels 是系统与用户的交互入口,为 Gateway 提供标准化的用户指令;

Hooks 是系统的事件扩展机制,基于 Gateway 分发的事件实现无侵入式的能力增强;

CronJob 是系统的主动执行引擎,通过 Gateway 调度 AI 智能体实现自动化任务。

四大核心概念的协同关系 — OpenClaw screenshot
四大核心概念的协同关系 — OpenClaw screenshot

四个模块相互协同,共同构成了 OpenClaw 高可扩展、高可控、高灵活的核心架构,支撑了个人 AI 智能体从交互、调度、扩展到自动化的全流程能力。

记忆系统:OpenClaw 的灵魂

这是 OpenClaw 最具突破性的设计。它采用分层记忆架构:

层级文件作用
身份层SOUL.md定义 AI 的性格、语调、行为边界
用户层USER.md用户的个人资料和偏好
操作层AGENTS.md操作指南、工作流程、能力边界
索引层MEMORY.md核心信息索引,保持精简(<40 行)
项目层memory/projects.md各项目当前状态与待办
基础设施层memory/infra.md服务器、API、部署配置速查
经验层memory/lessons.md踩过的坑,按严重程度分级
日志层memory/YYYY-MM-DD.md每日原始记录

社区用户的原话说得好:

"一个月后,你的龙虾就会摸清你的工作作息、沟通偏好、正在推进的项目、讨厌的细节、常用工具,还懂你十几项不同任务里 “按老样子来” 到底是什么意思。"

这种持续使用的 复利效应 是任何无状态 AI 工具无法复制的。

继续学习