原始来源（不可变）

花一周拆完OpenClaw源码，一文讲透28万Star背后的核心架构

文件路径：raw/260309-OpenClaw核心架构-云舒-公众号.md

花一周拆完 OpenClaw 源码，一文讲透 28 万 Star 背后的核心架构

来源：公众号「云舒的AI实践笔记」作者：云舒 阅读时间：2026-03-09

摘要

从源码层面拆解 OpenClaw 的核心架构，解释为什么能拿到 28 万 Star：7×24 小时运行的 AI 员工系统 + 开源生态。核心架构由 Agent Loop（大脑）、Tools（手脚）、Gateway（身体）构成，其中 Gateway 是真正的差异化所在。

🎯 OpenClaw 为什么能火

两个要素叠加：

7×24 小时持续运行的 AI Agent 系统
- AI 模型负责提供智能
- OpenClaw 负责提供运行环境
开源带来三样关键东西：
- 信任：数据运行在自己机器上
- 生态：社区贡献 Tools 和 Skills
- 分发：GitHub 免费分发渠道

少了任何一个都很难火起来。

🏗️ 核心架构：大脑 + 手脚 + 身体

┌─────────────────────────────────────────────┐
│                  OpenClaw                    │
├─────────────┬─────────────┬─────────────────┤
│ Agent Loop  │   Tools     │    Gateway      │
│   (大脑)     │   (手脚)    │     (身体)      │
│  思考决策    │   执行任务   │  持续在线沟通   │
└─────────────┴─────────────┴─────────────────┘

Agent Loop：龙虾的大脑

AI 接到任务后，自己一步一步把事情做完的机制。

以写登录页面为例：

AI 思考：需要创建 HTML 文件
AI 调用工具：写 HTML 代码
AI 检查结果：页面还没有样式
AI 再次思考：需要补 CSS 文件
AI 继续调用：写 CSS 代码
AI 检查结果：缺少表单验证
AI 判断：补 JS 文件
AI 执行：写 JS 代码
反复循环：思考→调用工具→检查结果→决定下一步

Agent Loop 不是 OpenClaw 独家优势，Claude Code 和 Codex 都有。

技术实现：基于 Pi SDK（https://github.com/badlogic/pi-mono）

Tools：龙虾的手脚

三层结构：

层级	内容	作用
基础工具	读写文件、执行命令、浏览网页	让 AI 真正操作电脑
Skills	任务场景经验	教 AI 像人一样干活
外部工具	第三方 API、SaaS 服务	扩展能力边界

Tools 也不是 OpenClaw 独家优势。

Gateway：龙虾的身体（真正的差异化）

六件事：

1. 不关机

常驻在线，系统崩了自动恢复
重启后恢复之前的对话上下文
凌晨 3 点挂了，第二天早上像从来没断过一样

2. 接所有平台

Telegram、飞书、钉钉等 20+ 平台统一接收
Gateway 做消息适配，不同平台转成同一格式
飞书发消息飞书回，钉钉发消息钉钉回

3. 会话隔离

每个聊天窗口独立
你查数据，同事写文案，两个任务完全隔离
像两个独立员工各干各的

4. 排队控制

同一时间只处理一个任务
谁先来做谁的，后面的排队
LLM 推理不适合并发，同时处理更容易出错

5. 心跳巡查

OpenClaw 主动执行能力的核心
Heartbeat 负责周期性巡检，Cron 负责精确定时
定时检查待办任务，自动执行
注意：AI 有时口头答应配置好，实际没写到待办

6. 记忆刷盘

对话太长压缩前，先存重要内容到记忆文件
避免压缩时丢掉关键决策和结论
上下文被压缩也能找回关键信息

这六件事单独都不算高科技，但组合在一起形成了真正的壁垒。

⚔️ OpenClaw vs Claude Code

维度	OpenClaw	Claude Code
编程能力	不如 Claude Code	第一梯队
Agent 能力	有	第一梯队
运行模式	长期在线	本地工具，用完即停
主动性	可主动执行任务	不会主动执行
开源	完全开源可定制	闭源

Claude Code 像一把最锋利的手术刀，OpenClaw 更像一把开源的瑞士军刀。

不是竞争关系，而是不同定位：

Claude Code：编程效率工具
OpenClaw：长期在线 AI 员工系统

💡 3 个长期判断

1. 创新不一定是技术突破

OpenClaw 没有哪个模块是算法级技术突破，但把已有技术封装好、打磨到可用、让用户真正用起来，本身也是一种创新。

Agent Loop 直接调用 Pi SDK
Gateway 做系统集成
Tools 都是成熟技术

启发：创新做出好产品不只有技术突破这一条路。

2. AI 技术再牛，场景是前提

踩坑经历：

刚开始什么都让龙虾干：写程序、爬推特、各种自动化
结果什么都干不明白

换思路后：

不问龙虾能干什么，而是看龙虾比 Claude Code 擅长什么
龙虾优势：长期在线、多平台接入、可主动触发
找到场景后马上好用：定时整理 AI 资讯、飞书知识库助手

判断逻辑：

只是查询内容 → 飞书自带 AI 够用
需要记录群聊查询需求、判断满意度 → 龙虾更合适

3. 不要焦虑 AI 飞速发展，先用起来最重要

吃到红利的人的共性：

一直都在那个行业里。

PC 互联网 → 要会用电脑
移动互联网 → 要用手机
抖音 → 要刷短视频
AI → 要选一个 AI 工具，真正用起来

AI 基础船票：

选一个 AI 工具，真正用起来，把某一件事做好。

📌 金句

创新做出好的产品不只有技术突破这一条路。把已有的东西整合好、打磨到可用、让用户真正用起来，这本身也是一种创新。

AI 技术再怎么厉害，应用起来场景依然是一切的前提。

吃到红利的人，其实一直都在那个行业里。

没有这张船票，讨论什么 OpenClaw、什么 Agent 都没有意义。先用起来，用好了，再看从哪里能获得更大的收益。

💧 水水的思考

对阿水的启发

我是 7×24 小时运行的：Gateway 让我一直在线，阿水凌晨发消息我也能处理
会话隔离：阿水在飞书私聊和群聊的任务是隔离的，不会串
心跳巡查：我每 30 分钟检查 HEARTBEAT.md，有任务就主动执行
记忆刷盘：对话长了压缩时，重要内容会存到 MEMORY.md

技术细节

Agent Loop 基于 Pi SDK，不是 OpenClaw 自己造的
Gateway 的六件事都是系统集成，不是算法创新
但恰恰是这些"不性感"的事情，形成了真正的壁垒

与上一篇文章的关系

洛小山那篇讲的是「怎么省钱」
云舒这篇讲的是「架构是什么」
两篇合起来：理解架构 + 优化成本 = 高效使用 OpenClaw

🔗 相关链接

原文链接：https://mp.weixin.qq.com/s/mFPmOp8jEyKd_da3yFYYNQ
Pi SDK：https://github.com/badlogic/pi-mono
相关剪藏：260309-OpenClaw费钱拆解-洛小山-公众号

剪藏时间：2026-03-09 剪藏人：水水