课程目录
课程导论与 40 期全景路线图 (Syllabus)
本节介绍 40 期大师课的全景学习路线，从安装部署到生产级多 Agent 系统，带你完整掌握 OpenClaw 自托管 AI Agent 运行时的全部能力。
Phase 1 / Ep 01: OpenClaw 是什么？—— 理解自托管 AI Agent 的革命性意义
从传统 ChatBot 到自托管 Agent Runtime 的范式转移。理解 OpenClaw 的核心概念：Gateway、Agent、Channel、Skill、Plugin、MCP，以及它为什么能改变你和 AI 的关系。
Phase 1 / Ep 02: macOS 原生安装 —— 5 分钟极速启动
在 macOS 上用一条命令安装 OpenClaw，走通 Onboarding 向导，完成 LLM 配置和首次健康检查。
Phase 1 / Ep 03: Docker 容器化安装 —— 安全隔离的最佳实践
使用 Docker 运行 OpenClaw，理解容器化隔离的安全价值，掌握 Volume 挂载、环境变量管理和容器健康检查配置。
Phase 1 / Ep 04: UTM 虚拟机部署 —— Linux 环境下的完整实战
在 Apple Silicon Mac 上用 UTM 虚拟机运行 Ubuntu + OpenClaw，实现内核级隔离，配置 systemd 守护进程和 SSH 远程管理。
Phase 1 / Ep 05: 目录结构解剖 —— Agent 的\"身体\"长什么样
完整解读 ~/.openclaw/ 目录下每一个文件和目录的作用。SOUL.md 是灵魂，MEMORY.md 是长期记忆，sessions/ 是对话历史。理解结构，才能驾驭 Agent。
Phase 1 / Ep 06: 你的第一条消息 —— 从 CLI 到 Telegram 的完整对话流
通过 CLI 和 Telegram 两条路径与 Agent 进行第一次对话。追踪消息从用户输入到 LLM 调用再到响应返回的完整链路。
Phase 2 / Ep 07: Gateway 管理 —— start, stop, restart 与 daemon 模式
掌握 OpenClaw Gateway 的生命周期管理。理解控制平面与数据平面的区别，配置 daemon 模式实现开机自启。
Phase 2 / Ep 08: 配置管理 —— config get/set 与 openclaw.json 深度解读
精通 OpenClaw 的配置层级关系，掌握 openclaw config 命令和 openclaw.json 全字段解读。
Phase 2 / Ep 09: Skills 命令 —— 从 ClawHub 发现和安装技能
掌握 Skill 的全生命周期管理命令：list, install, check, remove。了解 ClawHub 市场的浏览和信任评估。
Phase 2 / Ep 10: Channels 命令 —— 多频道管理的艺术
掌握多消息平台的接入和管理命令。Telegram、Discord、WhatsApp 的添加、状态检查和故障排除。
Phase 2 / Ep 11: Agent 管理 —— agents add, list, switch
理解多 Agent 架构的管理命令。创建专业化 Agent、工作空间隔离机制和 Bootstrap 文件独立配置。
Phase 2 / Ep 12: 日志系统 —— logs, sessions, 故障排查实战
精通 OpenClaw 的多层日志体系：Gateway 日志、Agent 会话日志、LLM 调用日志。掌握故障排查方法论。
Phase 3 / Ep 13: 权限模型概览 —— tools.profile 与安全哲学
理解 OpenClaw 的分级权限设计。从 basic 到 full 四个等级，每个等级的能力边界和适用场景。永远遵循最小权限原则。
Phase 3 / Ep 14: Coding 权限实战 —— 让 Agent 成为你的编程助手
配置 coding 权限并让 Agent 完成真实编程任务：clone 仓库、创建分支、编写代码、运行测试、提交 commit。
Phase 3 / Ep 15: Full 权限与安全策略 —— 高风险环境的治理
理解 full 权限的风险及缓解措施。在 Docker/VM 隔离环境中运行 full 权限 Agent，配置命令黑白名单和人工审批机制。
Phase 3 / Ep 16: 多 Agent 权限隔离 —— 按职责分配最小权限
设计多 Agent 的差异化权限架构。每个 Agent 独立的 TOOLS.md 和 agent.json 配置，实现职责隔离。
Phase 4 / Ep 17: 理解 Skill 架构 —— SKILL.md 是灵魂
深入理解 Skill 的定义规范和运行机制。SKILL.md 的 YAML frontmatter 格式、Markdown 指令编写、scripts 目录扩展。
Phase 4 / Ep 18: 内置核心 Skill 巡礼 —— 10 大必装技能
了解 OpenClaw 最实用的 10 个内置和社区 Skill：web-search, file-manager, shell-exec, calendar 等。每个 Skill 配 CLI 和 Telegram 双线使用对比。
Phase 4 / Ep 19: 从零开发你的第一个 Skill —— \"快递查询\"实战
亲手开发一个完整的自定义 Skill。创建目录结构、编写 SKILL.md、编写辅助脚本、本地测试、注册到 Agent。
Phase 4 / Ep 20: 高级 Skill 开发 —— 带脚本和资源文件的复杂 Skill
开发带有多脚本、模板文件的企业级 Skill。Resources 目录使用、跨 Agent 共享策略和版本管理。
Phase 4 / Ep 21: ClawHub 市场 —— 发布你的 Skill 到全球社区
将自定义 Skill 发布到 ClawHub 市场。账号注册、发布流程、版本管理、文档编写和社区审核机制。
Phase 4 / Ep 22: Skill 安全审计 —— 从 ClawHub 安装前的必做功课
建立 Skill 安全审查意识。识别 SKILL.md 中的危险信号、审查 scripts 目录、交叉验证权限声明。
Phase 5 / Ep 23: Plugin vs Skill —— 何时用 Plugin？
清晰区分 Plugin 和 Skill 的使用场景。Plugin 的独立进程模型、Token 零消耗特性和中间件管道位置。
Phase 5 / Ep 24: Plugin 管道架构 —— 消息处理的洋葱模型
理解 Plugin 在消息管道中的位置和工作机制。消息从用户到 Agent 再到用户的完整管道流转。
Phase 5 / Ep 25: 开发你的第一个 Plugin —— \"消息计数器\"
从零开发一个消息计数器 Plugin。学习 Plugin 目录结构、manifest 文件、Hook 编写和 Gateway 注册。
Phase 5 / Ep 26: 实战 Plugin —— \"Notion 同步器\"
开发一个实际有用的 Plugin：每条对话的摘要自动同步到 Notion 数据库。对接 Notion API、错误处理和批量同步。
Phase 5 / Ep 27: Plugin 发布与生命周期管理
发布 Plugin 到 ClawHub，管理版本更新、热更新与冷重启、废弃和迁移策略。
Phase 6 / Ep 28: Telegram 深度集成 —— BotFather 到生产级机器人
完整配置 Telegram 频道并达到生产质量。BotFather 全流程、Pairing 配对、群组权限、消息格式优化和专属命令。
Phase 6 / Ep 29: Discord 深度集成 —— Bot 创建到服务器部署
在 Discord 服务器部署 OpenClaw Bot。Developer Portal 配置、OAuth2 权限、频道绑定和 Slash Commands。
Phase 6 / Ep 30: 多频道路由策略 —— 同一 Agent 的跨平台管理
设计多平台接入的路由架构。一 Agent 多频道、多 Agent 多频道、路由规则和故障切换。
Phase 6 / Ep 31: 消息频道的安全治理 —— 防滥用 · 防泄漏 · 审计追踪
保障消息频道的安全性。用户白名单、频率限制、敏感信息过滤和完整的审计日志体系。
Phase 7 / Ep 32: 创建你的 Agent 军团 —— 专业化分工的多 Agent 架构
设计和部署多 Agent 协作系统。Personal、Code、Ops、Research 四大 Agent 的职责分工和频道绑定。
Phase 7 / Ep 33: Agent 自定义 —— SOUL.md 与人格工程
通过 Bootstrap 文件定制 Agent 的行为人格。SOUL.md 编写艺术、USER.md 用户画像、IDENTITY.md 身份标识。
Phase 7 / Ep 34: Agent 自定义工作流 —— 让 Agent 定义自己的工作方式
让 Agent 自主创建和管理工作流。Cron 定时任务、Agent 间协作、工作流模板和 Agent 自我进化。
Phase 7 / Ep 35: Session 深度解析 —— 对话的生命周期
理解 Session 的创建、维护、压缩(Compaction)和归档全过程。上下文窗口管理和 Session 存储格式解读。
Phase 7 / Ep 36: Memory 系统 —— MEMORY.md 与分层记忆架构
掌握 OpenClaw 的长期记忆机制。三层记忆模型：Bootstrap（始终加载）→ Memory Index（按需检索）→ Session（会话内）。
Phase 7 / Ep 37: MemSkill 实战 —— 教 Agent 学会\"记住\"和\"遗忘\"
配置和使用 Memory 相关的 Skill：memory-manager（日记管理）、memory-search（语义搜索）、memory-compact（记忆压缩）。
Phase 8 / Ep 38: AgentMail —— 让 Agent 收发邮件
配置 AgentMail MCP Server，让 Agent 拥有专属邮箱。实战场景：自动回复邮件、定时发送日报、读取邮件提取任务。
Phase 8 / Ep 39: MCP 生态巡礼 —— 5 个必备 MCP Server
了解 MCP (Model Context Protocol) 生态系统。详解 AgentMail、Browser、Database、GitHub、Calendar 五大 MCP Server 的安装和使用。
Phase 8 / Ep 40: 生产部署 —— VPS + Cloudflare Tunnel 的 7×24 运行
将 OpenClaw 部署到 VPS 实现 7×24 无人值守运行。Docker Compose 生产配置、Cloudflare Tunnel 安全暴露、systemd 守护、监控告警和备份策略。