本路线图以 OpenClaw 文档为主线，构建对另一种 AI Agent 实现的系统认知。建议在完成 Claude Code 学习的第一阶段（01-03）后开始，因为核心概念是共通的。
OpenClaw 与 Claude Code 的定位差异
| Claude Code | OpenClaw | |
|---|---|---|
| 定位 | 终端里的 AI 编程助手 | 全渠道个人 AI 助手 |
| 部署 | 本地 CLI + 云端 | 自托管 Gateway（长驻服务） |
| 通信 | 终端交互 / API | WhatsApp、Telegram、Slack、Discord、Web、CLI |
| 架构 | 单体 CLI 进程 | Gateway（WebSocket 服务器）+ 多客户端 |
| 会话 | 按目录隔离 | 按 channel + peer 隔离 |
| 多 Agent | Agent Teams（实验性） | Multi-Agent Routing（内置） |
核心差异：Claude Code 是”你坐在终端前和 AI 对话”，OpenClaw 是”AI 作为一个服务 7×24 运行，接受来自多个渠道的消息”。
学习路径
第一阶段：架构全景
| 序号 | 学习资料 | 原文链接 | 预计时间 |
|---|---|---|---|
| 1 | 01-OpenClaw-Gateway-架构 | architecture.md | 30min |
| 2 | 02-OpenClaw-Agent-Loop | agent-loop.md | 25min |
| 3 | 03-OpenClaw-Session与Memory | session.md + memory.md | 30min |
第二阶段：扩展机制
| 序号 | 学习资料 | 原文链接 | 预计时间 |
|---|---|---|---|
| 4 | 04-OpenClaw-Skill与Tool | skills.md | 25min |
| 5 | 05-OpenClaw-Hook系统 | hooks.md | 25min |
| 6 | 06-OpenClaw-自动化 | cron-jobs.md + webhook.md | 20min |
第三阶段：进阶
| 序号 | 学习资料 | 原文链接 |
|---|---|---|
| 7 | Multi-Agent Routing | multi-agent.md |
| 8 | Context Engine | context-engine.md |
| 9 | Plugin SDK | sdk-overview.md |
概念对照表（完整版）
| 概念 | Claude Code | OpenClaw | 异同 |
|---|---|---|---|
| 核心循环 | Agentic Loop（CLI 进程内） | Agent Loop（Gateway 内嵌 pi-agent-core） | 本质相同，但 OpenClaw 的循环是序列化的（per-session queue） |
| 持久指令 | CLAUDE.md（按目录层级） | AGENTS.md + SOUL.md + TOOLS.md + BOOTSTRAP.md（按角色分文件） | OpenClaw 更细分：身份/灵魂/工具/启动仪式各一份 |
| 自动记忆 | Auto Memory（~/.claude/projects/） | Memory（workspace 内 Markdown 文件）+ Vector Search | OpenClaw 支持向量搜索，比 Claude Code 更强 |
| 会话管理 | 按 git repo + 目录 | 按 channel + peer + agent，支持 dmScope 策略 | OpenClaw 更复杂，因为要处理多渠道多用户 |
| 会话重置 | /clear, /compact | /new, /reset + 定时重置（每日 4am）+ 空闲重置 | OpenClaw 有自动化策略 |
| 技能 | Skill（SKILL.md，三级加载） | Skill（SKILL.md，四级加载 + ClawHub 市场） | 格式相同！OpenClaw 多了 ClawHub 市场和 gating 机制 |
| Hook | JSON 配置 + shell/http/prompt/agent | TypeScript 函数 + 事件订阅 | Claude Code 更灵活（4种处理器），OpenClaw 更编程化（TypeScript） |
| Plugin Hook | 无（Hook 是统一的） | 独立体系：agent 生命周期 hook（before_model_resolve 等） | OpenClaw 有两层 Hook |
| 外部工具 | MCP Server | MCP Server + 内置工具（browser, exec, web-fetch 等） | 两者都支持 MCP |
| 子代理 | SubAgent（独立上下文） | Subagent（独立上下文 + sandbox） | 类似，OpenClaw 可能有容器隔离 |
| 多代理 | Agent Teams（实验性，peer-to-peer） | Multi-Agent Routing（内置，binding 路由） | 设计差异大：Claude Code 是协作，OpenClaw 是路由 |
| 定时任务 | Scheduled Tasks / /loop | Cron（schedules.json）+ Heartbeat | OpenClaw 更成熟 |
| 上下文引擎 | 内置（不可替换） | Context Engine（可插拔，plugin 可替换） | OpenClaw 更可扩展 |
| 部署 | 本地 CLI 或云端 | 自托管 Gateway（launchd/systemd） | 完全不同的运维模型 |
| 渠道 | 终端 + IDE + Web | WhatsApp, Telegram, Slack, Discord, Web, CLI | OpenClaw 多渠道是核心特性 |
文档全景（按需查阅）
concepts/（29 篇）
核心概念：agent-loop, architecture, session, memory, context-engine, context, compaction, system-prompt, agent, agent-workspace, multi-agent, models, model-providers, model-failover, streaming, messages, queue, presence, delegate-architecture, features, usage-tracking, session-pruning, session-tool, retry, oauth, timezone, typebox, typing-indicators, markdown-formatting
automation/（9 篇）
自动化：cron-jobs, hooks, webhook, poll, standing-orders, cron-vs-heartbeat, auth-monitoring, gmail-pubsub, troubleshooting
tools/（40 篇）
工具：skills, creating-skills, skills-config, subagents, exec, browser, web-fetch, slash-commands, btw, loop-detection, diffs, pdf, tts, thinking, 各种搜索引擎…
plugins/（17 篇）
插件 SDK：sdk-overview, sdk-setup, sdk-testing, building-plugins, building-extensions, architecture, manifest, agent-tools, bundles…
cli/（47 篇）
CLI 命令参考：agent, agents, cron, hooks, sessions, skills, memory, config, gateway, doctor, status…