第二部分-构建 Claw（开发篇）

文档摘要

构建篇：打开引擎盖本篇目标：从"驾驶员"进阶为"工程师"，理解 OpenClaw 的内部机制，掌握自定义 Skills、接入新渠道和架构优化的能力。 2026年初，当OpenClaw迅速攀升GitHub趋势榜时，大多数人看到的是一个好用的工具。但在这背后，有一个更值得注意的趋势：AI Agent正在从"黑盒产品"变成"可理解、可修改、可重建的基础设施"。在第一部分，你学会了"驾驶"——安装、配置、使用Skills、接入移动端。这项实用技能足以让你的日常效率提升一个量级。但想象一下这个场景：作为驾驶员，你只能再试一次或换个说法。但如果你理解引擎是如何运转的，你就能定位问题：是命令的文件匹配参数不正确？还是工具读取的文件范围不够完整？或者是LLM在总结时压缩掉了重要内容？

构建篇：打开引擎盖

本篇目标： 从"驾驶员"进阶为"工程师"，理解 OpenClaw 的内部机制，掌握自定义 Skills、接入新渠道和架构优化的能力。

2026年初，当OpenClaw迅速攀升GitHub趋势榜时，大多数人看到的是一个好用的工具。但在这背后，有一个更值得注意的趋势：AI Agent正在从"黑盒产品"变成"可理解、可修改、可重建的基础设施"。

在第一部分，你学会了"驾驶"——安装、配置、使用Skills、接入移动端。这项实用技能足以让你的日常效率提升一个量级。

但想象一下这个场景：


你：帮我把过去一周的重要邮件整理成周报
OpenClaw：好的，正在读取邮件... 奇怪，有些邮件没有显示在结果里
你：（困惑）为什么？是我的搜索词不对，还是它漏掉了？

作为驾驶员，你只能再试一次或换个说法。但如果你理解引擎是如何运转的，你就能定位问题：

是exec命令的文件匹配参数不正确？
还是read工具读取的文件范围不够完整？
或者是LLM在总结时压缩掉了重要内容？

这就是第二部分的起点：从"再试一次"到"我知道为什么"。

1 Why：为什么要理解底层

1.1 解决那些"说不清的问题"

使用AI工具时，最让人沮丧的不是"它做错了"，而是"我不知道它为什么错"。

让我们看几个真实的场景：

场景一：记忆丢失

你一周前告诉OpenClaw："我习惯用Tab而不是空格缩进。"今天它生成代码时，又用了4个空格。

作为用户，你只能再次纠正。但如果你理解它的记忆系统，你会知道：

用户偏好存储在MEMORY.md中
该文件有大小限制，旧内容会被压缩
更可能的是，你的偏好只是被当作了"对话历史"
解决方案是在AGENTS.md中明确写入编码规范

场景二：工具选择错误

你让OpenClaw分析项目代码结构，它用exec工具调用find命令时参数设置不合理，导致找不到关键文件。

理解工具系统后你会发现：

工具描述（description）的质量直接影响LLM的选择
OpenClaw的提示词中可能缺乏对文件搜索最佳实践的具体说明
你可以通过修改TOOLS.md来优化工具描述，让LLM做出更好的选择

场景三：响应太慢

一次简单的文件查询要等十几秒。

理解架构后，你能定位到：

是Gateway到模型服务的网络延迟？
还是LLM的推理时间过长？
或者是消息在队列中的排队等待？
你可以通过openclaw logs查看具体哪个环节在耗时

**这些问题的共同点是：表面上是"AI不听话"，实际上是"某个环节的配置或设计不符合预期"。**当你理解底层机制，诊断时间能从几小时缩短到几分钟。

1.2 掌握AI时代的"元能力"

让我们坦诚地说：OpenClaw不会永远是最好的AI Agent工具。

回顾AI发展历程：2023年是AutoGPT的爆发期，2024-2025年各类Agent框架层出不穷。技术迭代的速度远超任何人的学习速度。

但有一些概念是跨框架、跨时代的：

概念	在OpenClaw中	在其他框架中
Agent Runtime	Gateway→Agent Runtime→Clients/Nodes架构	LangChain的Chains、AutoGPT的Executor
Agent Loop	接收→上下文组装→模型推理→工具执行→回复	几乎所有Agent的核心范式
记忆分层	SOUL.md(身份)+MEMORY.md(事实)+对话历史	向量数据库+缓存+上下文窗口管理
工具抽象	read/exec/edit/write核心工具	Function Calling、Tool Use、Plugin系统
多渠道接入	Telegram/Discord/Slack适配器	统一的Channel Interface

第二部分要给你的，就是这些底层概念的具体实现案例。

当你理解了OpenClaw的ReAct循环实现，看到LangGraph的节点设计时就会恍然大悟："哦，这是把循环的每个阶段显式建模为图节点"。当你理解了OpenClaw的提示词系统，再看任何新的Agent框架时都会本能地去寻找"它的系统提示词在哪里定义"。

这种能力不会过期。无论明年流行什么框架，你都能快速上手，因为你看穿的是本质，不是表象。

1.3 创造的可能性

这里有一个值得关注的事实：OpenClaw的官方Skills数量有限，但社区已经涌现出大量第三方Skills。

这些Skills是谁写的？是像你一样理解了底层机制的开发者。

编程助手Skill：让OpenClaw理解团队代码规范，自动生成符合规范的代码
股票分析Skill：连接交易API，每天早上推送定制化的市场分析报告
智能客服Skill：接入公司知识库，自动回答常见客户问题
个人知识管理Skill：自动整理笔记、提取待办事项、建立知识关联

这些不是OpenClaw官方提供的功能，而是社区开发者基于OpenClaw架构创造的。

当你理解了如何构建Skills、如何修改提示词、如何接入新的渠道，你就从"消费者"变成了"创造者"。

更进一步，如果你对某个特定场景有独特需求，现有的OpenClaw可能无法完美满足。这时候你可以选择：

NanoClaw路线：用极小的代码量实现一个极简但专属于你的Agent
Fork路线：基于OpenClaw源码修改，适配你的工作环境
IronClaw路线：添加安全加固、审计日志、权限控制，满足合规要求

第二部分会展示这些路线的真实案例，让你看到从理解到创造的具体路径。

1.4 职业价值的延伸

让我们现实一点：学习这些能给你带来什么实际的好处？

根据AI开发市场的趋势观察：

能够熟练使用AI Agent工具的开发者，在就业市场上更具竞争力
能够开发定制Skills、接入企业系统的开发者，在自由市场上有较高的需求
能够基于Agent架构进行深度定制的技术顾问，项目价值通常在较高区间

这个市场的需求是真实的，且目前的供给相对不足。

更重要的是，这种技能具有累积效应。你今天理解的ReAct循环、明天掌握的Skill开发、后天学会的多渠道接入，这些能力会叠加在一起，让你在AI应用开发领域的竞争力指数级增长。

2 What：你会看到什么

第二部分不是源码阅读指南，而是一次架构探险。我们会从不同角度、不同深度来观察OpenClaw这个系统。

2.1 第一板块：解剖OpenClaw（第1-7章）

这一板块会像解剖精密仪器一样，逐层深入OpenClaw的核心机制。

第1章：核心定位与设计理念

探讨一个根本问题：Agent Runtime和Chatbot的本质区别是什么？

这不仅仅是"一个会执行一个不会"那么简单。你会发现：

为什么OpenClaw选择自托管而非云端托管
核心工具（read/exec/edit/write）背后的设计哲学
WebSocket Gateway架构如何让系统保持松耦合
这些设计选择带来的优势与代价

第2章：ReAct循环——Agent的"思考-行动"引擎

深入理解Agent的核心工作机制：

ReAct循环的完整生命周期
串行执行与因果一致性
循环深度与任务复杂性的关系
三种架构哲学的分野：计划派、反应派、ReAct
状态管理与分层记忆结构

第3章：提示词系统——Agent的"灵魂工程"

这是OpenClaw最独特的设计之一：用多个Markdown文件来定义Agent的"人格"和"知识"。

SOUL.md：Agent的身份、性格、行为准则
USER.md：用户画像、偏好、交互习惯
AGENTS.md：工作流程与决策规则
TOOLS.md：环境信息备忘录
IDENTITY.md：Agent基础身份信息
MEMORY.md：长期记忆的存储格式
HEARTBEAT.md：定时任务的触发条件
BOOTSTRAP.md：新工作区初始化引导

你会理解：

这些文件如何被组合成最终的系统提示词
热更新机制如何让修改立即生效
如何通过调整提示词来精细控制Agent行为
Token限制的分配策略（多少给系统提示词，多少给对话历史）

第4章：工具系统——Agent的"手脚"

OpenClaw的核心能力来自于它的工具。我们会深入：

四个基础工具（read/write/edit/exec）的设计哲学
工具描述即接口：如何让LLM准确理解工具用途
技能（Skills）的懒加载机制
最小完备集：为什么四个工具足够

第5章：消息循环与事件驱动——Agent的"心跳"

这是Agent的"心跳"。你会看到：

命令队列与泳道模型
四种任务类型：Main、Cron、Subagent、Nested
时间感知与心跳机制
分层容错设计

第6章：统一网关——一个入口，万千渠道

OpenClaw可以同时运行在多个平台上。我们会探讨：

Gateway的架构位置与职责
适配器模式与开闭原则
消息模型的三层抽象：Session/Conversation/Message
双向通信与身份识别

第7章：安全沙箱——自由与约束的平衡

深入理解OpenClaw的安全机制：

三层纵深防御架构
文件系统沙箱与隔离
命令执行沙箱的三层模型
提示注入攻击的防御

2.2 第二板块：探索替代方案（第8-10章）

理解一个系统的最好方式，是看看其他人是如何解决同样问题的。

第8章：轻量化方案——当 OpenClaw 太重了怎么办

NanoClaw：极简TypeScript代码实现，单进程+容器隔离
Nanobot：Python教科书级实现，研究友好+MCP支持
ZeroClaw：Rust实现，<5MB内存，$10硬件可运行

你会看到：复杂的功能可以被简化到什么程度？哪些功能是不可或缺的，哪些是可以牺牲的？

第9章：安全加固方案——给 Agent 穿上盔甲

IronClaw：企业级安全架构
- WASM沙箱：默认不信任任何外部工具
- 密钥保护：零暴露模型
- 提示词注入防御：多层滤网
- Docker沙箱：最后一道防线

第10章：硬件方案——让 Agent 跑在「虾」上

PicoClaw：运行在嵌入式设备上的低功耗版本
- 硬件选型：ARM为什么赢了？
- 功耗优化：如何让Agent在电池供电下运行
- 离线能力：完全无网络环境下的本地推理

2.3 第三板块：创造你自己的（第11-15章）

这一板块是关于"动手"的，但不是枯燥的编码教程。我们会通过一个真实案例——杂志社编辑的自动化需求——让你看到每种定制方法到底能做到什么程度。

第11章：定制路径概览

还是四种"玩法"，但这次帮你决定从哪层开始：

配置玩家：按照adopt部分的内容简单修改配置
提示词工程师：更精细的风格控制
Skill开发者：要接外部API、处理复杂逻辑
工作流架构师：多任务串联、多Agent协作

第12章：提示词工程深度优化

基于第3章的原理，但不再介绍"有哪些文件"，而是聚焦怎么用：

多文件组合策略：SOUL.md和SKILL.md怎么配合才能不打架
调试技巧：热更新在手，怎么快速试错找到最佳配置
Memory精细化：第3章说MEMORY.md会被压缩，怎么让重要内容不被挤掉
案例：小李的"汽车编辑"专属人格——从改写几版到定稿的全过程

第13章：Skill开发实战

基于第4章的工具系统，从描述到代码：

Frontmatter高阶配置：不只是name和description，还有自动安装、依赖声明
impl/实战：中等复杂度的TypeScript——RSS抓取、邮件解析、错误处理
Subagent调用：第4章提过subagent工具，这里看怎么在Skill里用它分解任务
案例：小李的新闻聚合Skill——自动抓取、摘要生成、标签分类一站式搞定

第14章：智能工作流编排

基于第5章的循环和第6章的渠道，搭一条自动化流水线：

Heartbeat+Cron组合拳：第5章讲过这两种定时机制，怎么搭配用才不生乱
浏览器自动化进阶：第4章的Playwright工具，做多站点登录和智能抓取
多Agent协作：第3章的AGENTS.md角色定义，建一个"编辑部"：有人专职监控，有人负责审核，有人对接美编
案例：小李的早晨——睁眼就看到Agent准备好的热点报告和润色建议

第15章：完整定制案例

三个从真实需求出发的案例，展示从想法到落地的全过程：

编程助手型：深度集成VSCode，理解项目结构，生成符合团队规范的代码
个人效率助手型：整合邮件、日历、笔记、待办事项的智能助理
智能客服机器人型：基于知识库的多轮对话系统，支持人工接管

3 How：如何探索这一部分

3.1 三条入口路径

我们设计了三个不同的入口，你可以根据自己的状态选择：

路径A：原理派

如果你好奇"它是怎么工作的"，从第1章开始，按顺序读到第7章。这是理解最系统的路径。

路径B：对比派

如果你已经有一些使用经验，想知道"还有什么其他可能"，跳到第8章看案例分析。看到NanoClaw的极简实现，你会对"什么是最小必要功能"有全新的认识。

路径C：需求派

如果你已经有一个具体的定制目标（"我想让它接入公司的XX系统"），直接跳到第11-15章。边读边做，在实践中有针对性地回头查原理。

3.2 理解的层次

对于每一个概念，你不需要"全都要"。根据你的目标，选择理解的深度：

深度	适合人群	学习方式
概念级	大多数读者	知道"有这个模块"、"它负责什么"就够了
原理级	想深入理解的读者	理解它是如何工作的、为什么这么设计
代码级	想定制开发的读者	阅读源码、理解实现细节、能修改

例如，对于命令队列（Command Queue）：

概念级：知道"Command Queue负责序列化命令执行"，了解它在架构图中的位置
原理级：理解队列调度、并发控制、泳道模型（队列模式按渠道配置：steer/followup/collect/steer-backlog/steer+backlog/queue/interrupt）
代码级：能阅读并修改Command Queue的实现，添加新的队列模式或处理器

你可以在不同概念上选择不同的深度。比如在提示词系统上深入（因为你想定制Agent性格），但在渠道接入上保持概念级（因为你只用Telegram）。

3.3 实践的建议

虽然我们没有强制的"课后作业"，但我们建议你：

读一章，改一点

读完提示词系统的章节，试着修改你的SOUL.md，看看Agent的回应风格如何变化
读完工具系统的章节，试着写一个最简单的Skill（比如一个返回当前时间的工具）
读完架构解析的章节，试着用openclaw logs观察一次完整的消息流转

带着问题读

如果你在使用OpenClaw时遇到了奇怪的行为，把它当作一个探索的契机：

"为什么它这次没有调用我预期的工具？" → 去第4章看工具选择的机制
"为什么它忘了我们之前的约定？" → 去第3章看记忆系统的设计
"为什么响应这么慢？" → 去第5章看消息循环的执行流程

做笔记，画图表

学习复杂系统的最好方式，是用你自己的方式重新组织它：

画一张你自己的架构图（即使不准确，也是你理解的外化）
列出你关心的概念和它们的关联
记录你遇到的问题和找到的解决方案

4 The Tradeoff：代价与收益

在进入之前，我们需要诚实地谈谈代价。

4.1 你需要投入的

注意： 学习这部分内容需要投入更多精力，但回报是长期的。

点击展开：学习代价详情

时间

第二部分的内容量比第一部分多。完整阅读所有章节需要一定的投入时间。如果要动手实践，时间会更长。

但记住，这不是考试，没有截止日期。你可以用一个月，也可以用半年。

认知负荷

这部分内容涉及：

TypeScript/JavaScript代码（OpenClaw使用Node.js开发）
系统设计概念（事件驱动、消息队列、状态管理）
AI原理（LLM的行为特性、提示词工程、ReAct范式）

如果你在某些领域不熟悉，可能需要额外查资料。这很正常。

挫败感

理解复杂系统不是线性的。你可能花了一小时读某章，却感觉什么都没懂。或者你觉得自己懂了，动手时却发现完全不是那么回事。

这种挫败感是学习曲线的正常部分。每一个真正理解OpenClaw的人都经历过。

4.2 你会得到的

解决复杂问题的能力

当你遇到OpenClaw的奇怪行为时，诊断时间从几小时变成几分钟。当你需要定制功能时，你知道从哪里下手。

跨框架的迁移能力

明年出现新的Agent框架时，你能在几天内上手，因为你看穿的是本质。

创造的可能性

从修改配置到开发Skills，从Fork修改到从零构建，你有一整套工具来表达你的想法。

潜在的经济回报

无论是求职时的竞争力提升，还是作为自由职业者的技能储备，这都是一个有市场需求的能力。

4.3 一个诚实的建议

不是每个人都需要深入这一部分。

如果你使用OpenClaw的过程中：

现有Skills已经满足了你的大部分需求
你没有遇到"无法理解"的奇怪行为
你对"底层原理"没有强烈的好奇心
你的时间和精力有限

那么，停留在第一部分是完全合理的选择。你可以随时回来，当某个具体的问题驱动你深入时。

最好的学习动机是"我需要解决这个问题"，而不是"我应该学完这个教程"。

5 从驾驶员到工程师

让我们回到那个汽车的比喻。

第一部分教你驾驶——踩油门、打方向、看仪表盘。这让你能快速到达很多地方。

第二部分带你打开引擎盖——看引擎如何燃烧、变速箱如何换挡、电路如何控制。这不会让你开得更快，但当你听到异响时，你知道问题在哪里。当你想要改装时，你知道从哪里下手。当你面对一辆陌生的车时，你能更快地理解它。

更重要的是，你开始具备设计和制造的能力。

也许你不会真的去造一辆车。但当你理解了引擎的原理，你对"移动"的理解就永远改变了。你不再是交通工具的被动消费者，而是有能力参与创造的人。

AI Agent正在成为一种基础设施工具，就像数据库、Web服务器、操作系统一样。今天理解它的底层机制，就像1995年理解HTTP协议、2005年理解Linux内核、2015年理解Docker容器。

这种理解不会立刻变现，但它是长期投资。它会在未来的某个时刻，让你看到一个别人看不到的机会，或者解决一个别人无法解决的问题。

现在，选择你想开始的地方：

第1章：核心定位与设计理念 —— 理解Agent Runtime的本质，看看OpenClaw为什么被设计成现在这样