概述
OpenClaw 是一个开源自托管 AI Agent 系统。把官方指南《OpenClaw 橙皮书》和社区实战手册《小龙虾使用手册（蓝皮书）》放在一起看，会更容易判断它适合拿来做什么，也能少走一些配置和落地时常见的弯路。
两本文档各讲什么
《OpenClaw 橙皮书》
这是官方权威资料，重点放在原理、架构和部署。里面会讲架构演进、Gateway-Node-Channel 三层架构、四层记忆系统、本地与 Docker 部署、云厂商一键部署、渠道接入、Skills 系统、模型配置，以及安全和成本控制。
如果你刚接触 OpenClaw，先看这本更合适。它不追求案例的热闹，讲的是系统到底怎么搭起来。
《小龙虾使用手册（蓝皮书）》
这本更偏中文社区的实操手册，内容重心是安装部署、模型配置、案例拆解和踩坑经验。它更像一份落地备忘录，尤其适合已经决定要上手的人。
它还会把一些真实场景说得更直接，比如行业应用、Skill 开发、ClawHub 发布流程，以及多 Agent 的几种常见玩法。优点是离实践近，缺点是你得自己判断哪些经验适合当前环境。
先抓住这些核心点
橙皮书里最该先明白的东西
- OpenClaw 的本质是开源自托管 AI Agent 系统，数据自己掌握。
- 核心架构是 Gateway-Node-Channel 三层，通信依赖 WebSocket。
- 记忆分成 SOUL、TOOLS、USER、Session 四层，各自管的东西不同。
- 部署路径包括本地 npm、Docker 和云厂商部署，入门时可以先选最省事的一条。
- 渠道接入覆盖 QQ、飞书、钉钉、Telegram、WhatsApp 等常见平台。
- Skills 系统对应 ClawHub 技能市场，但这块要留意供应链安全。
- 模型配置支持 Claude、GPT 和国产模型，Fallback 链能把成本压下来。
- 安全这件事不能省，认证、白名单和 RCE 防护都要提前开好。
蓝皮书更实用的部分
- 它会列出一些能跑通的业务案例，比如预测套利、自动化服务、内容营销等。
- 覆盖的行业更杂，内容创作、法律、电商、教育都能找到对应思路。
- 一个最小 Skill 只需要
SKILL.md，上手门槛不高。 - 多 Agent 方案通常会落到流水线、并行或层级架构这几种模式。
- 常见坑也写得比较直白，API 账单、提示词注入、Token 泄露都在里面。
学习顺序怎么安排
先把基础跑通
先认识 OpenClaw 的定位，再把环境装起来。模型 API、渠道接入和安全设置放在一起处理，别拆得太散，不然很容易只装了一半。
再去碰实战
等基础通了，再看内容自动化、邮件处理这类案例。接着自己做一个简单 Skill，先别追求复杂功能。预算控制、权限控制这些事也要同步做，不然很容易在测试阶段把成本和权限问题一起踩出来。
最后再决定方向：是做副业服务，还是继续深挖技能开发，或者直接往企业落地方向走。
我会怎么选
如果目标是理解 OpenClaw 这套系统怎么运转，先看《橙皮书》；如果目标是尽快把它用起来，或者想看别人怎么踩坑，《蓝皮书》更值时间。
两本一起看比较顺。前者补结构，后者补经验。单看其中一本都能入门，但只看理论容易停在架构图上，只看案例又容易照着抄却不知道哪里会出问题。
结论
OpenClaw 适合想自己掌控数据、又愿意折腾部署和配置的人。橙皮书解决'它是什么、怎么搭'，蓝皮书解决'怎么落地、哪里容易翻车'。把这两份材料串起来，基本就能形成一条从认知到实操的完整路径。
