✨ 核心特色

• 🎓 双线学习路径：Claude Code 编程线 + OpenClaw 助手线，各取所需
• 🚀 快速上手：Claude Code 3 小时上手 / OpenClaw 5 分钟跑起来
• 👶 小白友好：72个术语解释、40个生活类比、170+FAQ
• 💻 实战导向：70+个可运行代码示例，边学边练
• 📊 质量保证：关键版本号与 CLI 行为优先对照 官方 Release / 文档 修订；细节仍可能随上游快速变化，请以你本机版本为准
• 🔄 持续更新：适配最新版本（Claude Code 2.1.92 / OpenClaw 稳定版 v2026.3.28；预发布见 Releases）

📚 教程目录

🤖 Part 1：Claude Code — Anthropic 官方编程神器

| 序号 | 教程名称 | 学时 | 难度 | 必学度 | 说明 | |------|---------|------|------|--------|------| | 01 | Claude Code完整安装指南 | 2-3h | ⭐ | ⭐⭐⭐ | 环境搭建、API配置、IDE集成 | | 02 | 基础使用完整指南 | 4-6h | ⭐ | ⭐⭐⭐ | 三种使用模式、30+命令详解 | | 03 | Commands系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐ | Slash 命令、Skills 工作流与兼容层 | | 04 | MCP集成完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 10+核心服务器、自定义开发 | | 05 | Hooks系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 多事件 Hook、4 类处理器、自动化工作流 | | 06 | Subagent子代理完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 官方 Subagents、Task 委派、Agent Teams（实验性） | | 07 | Skills定制完整指南 | 6-8h | ⭐⭐ | ⭐⭐ | 创建可复用功能包 | | 08 | Plugins生态完整指南 | 4-6h | ⭐⭐ | ⭐ | /plugin、市场、作用域与本地开发 | | 09 | Agent-SDK完整指南 | 6-8h | ⭐⭐⭐ | ⭐⭐ | 编程开发AI Agent | | 10 | 综合实战完整指南 | 2-3h | ⭐⭐⭐ | ⭐⭐ | 团队协作、CI/CD集成 | | 11 | 企业实战完整指南 | 4-6h | ⭐⭐⭐ | ⭐ | 企业级最佳实践 | | 12 | Remote Control完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 跨设备继续本地会话、/remote-control、claude remote-control | | 13 | Channels与计划任务完整指南 | 2-3h | ⭐⭐⭐ | ⭐ | --channels、/schedule、/loop、CronCreate |

速查：Claude Code 快速导航卡

🦞 Part 2：OpenClaw — 开源 AI 助手

| 序号 | 教程名称 | 难度 | 说明 | |------|---------|------|------| | OC-00 | 阅读指南 | 🟢 | 术语表、文档地图、4条阅读路线 | | OC-01 | 项目介绍 | 🟢 | OpenClaw 是什么、发展历史、核心架构 | | OC-02 | 安装部署 | 🟢 | macOS / Linux / Windows 全平台安装 | | OC-03 | 快速开始 | 🟢 | 5 分钟跑起来第一个对话 | | OC-04 | AI 模型配置 | 🟡 | 接入 OpenAI / Claude / Ollama 等模型 | | OC-05 | 消息平台接入 | 🟡 | 连接 WhatsApp / Telegram / Discord / 飞书等平台 | | OC-06 | 技能系统 | 🟡 | 技能生态与自定义技能开发 | | OC-07 | 记忆系统 | 🟡 | AI 如何记住你的偏好和上下文 | | OC-08 | 多 Agent 协作 | 🔴 | 一个网关跑多个独立 AI 助手 | | OC-09 | Docker 部署 | 🔴 | 容器化部署与 VPS 远程访问 | | OC-10 | 安全配置 | 🔴 | 安全配置、CVE 防护、权限管理 | | OC-11 | 常见问题 | 🟢 | 踩坑指南与解决方案 |

📋 环境要求

Claude Code

• 操作系统：Windows 10+、macOS 10.15+、Linux
• 安装方式：支持标准安装（npm install -g @anthropic-ai/claude-code，需 Node.js 18+）和原生二进制安装（beta / 改进安装路径）
• 认证方式：可用 Claude 订阅登录，也可用 Anthropic Console / 第三方兼容提供商配置
• IDE：VS Code、Cursor、Windsurf 或其他支持的编辑器

⚠️ 2026年更新：Claude Code 已提供原生二进制安装，但 Node.js 18+ 的标准 npm 安装路径仍然受支持。本仓库安装指南现同时覆盖两条路径，并明确各自适用场景。

OpenClaw

• Node.js：24.x 推荐，22.14+ 兼容
• AI 模型 API Key：OpenAI / Anthropic / Google 等（或使用 Ollama 本地模型免 Key）
• 操作系统：macOS / Linux / Windows（推荐 WSL2）

🚀 快速开始

克隆仓库

git clone https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh.git
cd Claude-Code-x-OpenClaw-Guide-Zh

Claude Code 路线（3小时上手）

Step 1（60分钟）：01-安装指南 → 路径A快速上手
Step 2（30分钟）：04-MCP集成 → 第2部分快速开始
Step 3（30分钟）：05-Hooks系统 → 第2部分快速开始
完成 ✅ 能用Claude Code + 能用MCP + 能用Hook

OpenClaw 路线（1小时上手）

Step 1（15分钟）：OC-01 项目介绍 → 了解全局
Step 2（20分钟）：OC-02 环境安装 → 装好环境
Step 3（10分钟）：OC-03 快速开始 → 跑起第一个对话
Step 4（15分钟）：OC-04 模型配置 → 接入 AI 模型
完成 ✅ 能用OpenClaw + 能和AI对话

完整掌握路径

Week 1-2：Claude Code 安装 + 基础使用 + MCP
Week 3-4：Claude Code Hooks + Skills + Plugins
Week 5  ：Claude Code 模型配置 + Remote Control + Channels/计划任务
Week 6  ：Claude Code Agent-SDK + 综合实战
Week 7  ：OpenClaw 安装 + 快速开始 + 模型配置
Week 8  ：OpenClaw 消息平台 + 技能系统 + 记忆系统
Week 9  ：OpenClaw 多Agent + Docker部署 + 安全

📊 项目统计

| 指标 | 数值 | |------|------| | 教程总数 | 25 篇完整教程（Claude Code 13 / OpenClaw 12）+ 1 速查卡 | | 总字数 | ~130,000 字 | | 代码示例 | 70+个（全部可运行） | | FAQ数量 | 170+ 个 | | 覆盖AI模型 | 29 个提供商（OpenClaw） | | 覆盖消息平台 | 15+ 个（OpenClaw） | | Claude Code版本 | 2.1.92（2026-04-05 验证） | | OpenClaw版本 | 稳定版 v2026.3.28（2026-04-05 对照 Releases）；列表含预发布时请自行取舍 |

🎯 适用人群

• ✅ 零基础小白：从未接触过 AI 编程工具，想系统学习
• ✅ 开发者：想用 Claude Code 提升编程效率 + 用 OpenClaw 自动化日常工作
• ✅ 团队负责人：为团队制定 AI 工具使用规范
• ✅ 企业用户：企业级部署和最佳实践
• ✅ AI 爱好者：想搭建自己的 AI 私人助手

💡 学习建议

初学者（零基础）

想学编程 AI → 从 Claude Code Part 1 开始（01 → 04 → 05）

想玩 AI 助手 → 从 OpenClaw Part 2 开始（OC-01 → OC-02 → OC-03）

都想学 → 先 Claude Code 3 小时上手，再 OpenClaw 1 小时上手

进阶者（有基础）

• Claude Code 重点：04-MCP、05-Hooks、06-Subagent、07-Skills
• OpenClaw 重点：06-技能系统、08-多Agent路由

高级者（深度定制）

• Claude Code：09-Agent-SDK、10-综合实战
• OpenClaw：08-多Agent、09-Docker部署、10-安全

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

• 发现错误或过时信息，请提交 Issue
• 有改进建议，欢迎提交 PR
• 想分享使用经验，欢迎在 Discussions 讨论

📄 许可证

本项目采用 MIT License 开源协议。

🙏 致谢

感谢所有为 Claude Code 和 OpenClaw 生态做出贡献的开发者和社区成员！

📋 更新日志

v3.1 (2026-03-18) | Claude Code v2.1.69-v2.1.78 新功能补充

v3.2 (2026-04-05) | Claude Code v2.1.92 + OpenClaw 差量同步

本次重点修正

• Claude Code：同步安装、基础使用、MCP、Agent SDK、Commands、Hooks、Subagents、Plugins、企业实战等章节的版本口径
• Claude Code：新增 2 篇缺失专题教程（Remote Control、Channels/计划任务），模型配置整合到安装指南
• Claude Code：修正 README 与安装教程中“原生安装 = 完全不需要 Node.js”这一过满表述，改为“原生安装与 npm 标准安装并存”
• Claude Code：补齐 /plan、/plugin、/release-notes、/rewind、/insights、/schedule、/statusline 等较新内置命令的上下文说明
• Claude Code：补齐 /btw、/config、/desktop、/diff、/install-github-app、/mobile、/reload-plugins、/remote-control、/tasks、/theme、/ultraplan 等当前命令面
• Claude Code：修正 Hooks 章节中“固定 20 种 Hook”这一过时说法，改为按事件族和处理器类型理解
• Claude Code：修正 Subagent 章节中过度依赖第三方代理包的问题，明确官方 Subagents 与实验性 Agent Teams 的边界
• Claude Code：修正 Plugins 章节中过时的本地加载叙述，补上当前 /plugin、market、scope、manifest、LSP、/reload-plugins、持久化数据目录等结构
• Claude Code：补充“自定义 slash 工作流已并入 Skills 体系，.claude/commands 主要作为兼容层”的说明
• OpenClaw：同步阅读指南、项目介绍、安装部署、快速开始、模型配置、技能系统、FAQ 等章节的当前主路径
• OpenClaw：统一安装基线为“Node 24 推荐，22.14+ 兼容”，补充官方 install.sh 快速安装路径
• OpenClaw：统一 Windows / WSL2 表述为“原生可用，WSL2 更稳定”
• OpenClaw：清理 README 和项目介绍中容易过时的 Stars / 历史增长数字表述

v3.3 (2026-04-05) | OpenClaw 稳定版基线与全文口径

• OpenClaw：README 徽章与统计表改为 稳定版 v2026.3.28（与 GitHub Releases 2026-04-05 页面对照）；说明 预发布（如 v2026.4.1-beta.1）可能与稳定版并存
• OpenClaw：OC-00 / OC-02 及 OC-01/03/04/05/06/07/08/09/10/11 文首补充 教程版本基线 交叉引用，减少各篇版本表述漂移
• OpenClaw：目录与贡献路线用语中「源码」改为「仓库 / 本地构建」等中性表述（安装篇章节标题同步）

v3.0 (2026-02-25) — 双顶流合璧

重大更新

• 项目升级为 Claude Code & OpenClaw 双教程
• 仓库更名为 Claude-Code-x-OpenClaw-Guide-Zh
• 新增 OpenClaw 11 篇完整中文教程（基于 v2026.2.23）+ 1 篇阅读指南
• 目录结构重组：docs/claude-code/ + docs/openclaw/
• OpenClaw 全部文档经官方文档与发行版 CLI 对照校验，修正技术错误（配置格式、端口、CLI 命令、平台支持等）
• OpenClaw 全部文档加入小白友好元素（难度标记、术语解释、阅读路线、可跳过标记）

OpenClaw 教程内容

• OC-00 阅读指南：术语表、文档地图、4条阅读路线（小白速通/日常使用/深度定制/生产部署）
• OC-01 项目介绍：发展历史、核心架构、15+消息平台、29个AI模型提供商
• OC-02 环境安装：macOS / Linux / Windows / Docker 全平台安装
• OC-03 快速开始：5 分钟跑起第一个对话
• OC-04 AI 模型配置：OpenAI / Claude / Gemini / Ollama 等模型接入
• OC-05 消