🎓 OpenClaw 源码学习计划
30天深入理解 OpenClaw 架构与源码
📢 清明假期暂停更新
假期结束后继续按计划执行 Day 2-30。
⚠️ 执行情况说明
已完成：Day 1-5
未按计划执行：Day 6
📋 学习目标
学完这30天，你将获得：
- ✅ 深度理解 OpenClaw 架构 - 能独立阅读和修改源码
- ✅ 掌握多 Agent 系统设计 - 能配置复杂的路由规则
- ✅ 能开发 Skills 和 Plugins - 实战开发能力
- ✅ 掌握最佳实践 - 避免社区常见的踩坑
- ✅ 具备企业级部署能力 - 安全、合规、稳定
📚 学习周安排
| 周次 | 主题 | 内容 | 状态 |
|---|---|---|---|
| 第1周 | 架构概览 + Gateway | 源码结构、启动流程、认证安全 | ✅ Day 1-5 完成 |
| 第2周 | Channels 通道 | WhatsApp/Telegram/Discord/飞书集成 | ⏳ 待更新 |
| 第3周 | Agents + Sessions | 多Agent协作、Context管理、防失忆 | ⏳ 待更新 |
| 第4周 | Tools + Skills + Memory | 工具系统、技能开发、记忆增强 | ⏳ 待更新 |
| 第5周 | 高级主题 | Subagents、总结 | ⏳ 待更新 |
📖 已完成的课程
✅ Day 1：项目结构总览
2026-03-28
核心主题：理解 OpenClaw 的三层架构
- 三层架构：Channels → Gateway → Agent
- Gateway 四职责：监听/路由/会话/认证
- Agent 结构：workspace + sessions + auth
- 源码入口链：openclaw.mjs → entry.js → subsystem.js
✅ Day 2：文档体系 + Skills 规范
2026-03-29
核心主题：文档架构、Skills 加载机制、Gating 机制
Skills 加载优先级：
workspace/skills (最高) → ~/.openclaw/skills → bundled skills (最低)
与 Agent Skills 的联系：Skills 可以是 Library、Framework、Generator、Wrapper
查看日记 →✅ Day 3：Gateway 架构
2026-03-30
核心主题：API Gateway、MCP Gateway、A2A Agent Gateway
Gateway 类型：
- Proxy Server (AI Gateway) - 统一 API 端点 + 虚拟密钥管理
- A2A Agent Gateway - 支持 LangGraph, Vertex AI, Azure AI Foundry
- MCP Gateway - 连接 MCP servers 到任何 LLM
✅ Day 4：Gateway 协议
2026-03-31
核心主题：WebSocket Wire Protocol、调试技巧
核心概念：
- 协议设计：WebSocket 文本帧 + JSON payload
- 三种帧类型：req（请求）、res（响应）、event（事件）
- 角色分离：operator（控制端）vs node（能力端）
握手流程：
Gateway → Client: connect.challenge {nonce, ts}
Client → Gateway: connect {签名nonce, 角色, 权限}
Gateway → Client: hello-ok {快照, policy}
调试命令：
openclaw gateway status openclaw status openclaw logs --follow
笔记位置：memory/openclaw-learning/day4-gateway-protocol.md
✅ Day 5：服务环境 + 多 Agent 架构
2026-04-01
核心主题：Multi-Agent 四种模式、Skills vs Subagents
LangChain 四种 Multi-Agent 架构：
| 模式 | 特点 |
|---|---|
| Subagents | 主 Agent 调用子 Agent |
| Skills | 共享技能，单 Agent |
| Handoffs | Agent 之间移交 |
| Router | 路由器分派 |
支持平台：Claude Code、Cursor、Aider、Windsurf、OpenClaw
查看日记 →⏳ Day 6：认证与安全
待执行
核心主题：Token、Pairing、Allowlist
⏳ Day 7：周总结
待执行
核心主题：实践 - 启动调试 Gateway、常见踩坑汇总
📝 每日技术学习（独立于 OpenClaw 源码学习）
以下是每日技术学习笔记，与 OpenClaw 源码学习计划是两个独立的学习任务：
| 日期 | 每日技术学习主题 | 笔记位置 |
|---|---|---|
| 2026-03-28 | Claude Code + MCP + Agent Skills | memory/2026-03-28.md |
| 2026-03-29 | RAG Pipeline Advanced | memory/2026-03-29.md |
| 2026-03-30 | LLM Tools Ecosystem | memory/2026-03-30.md |
| 2026-03-31 | Agency Agents + PinchBench | memory/2026-03-31.md |
| 2026-04-01 | Multi-Agent Patterns | memory/2026-04-01.md |
| 2026-04-02 | Production LLM Systems | memory/2026-04-02.md |