AI 双顶流 · 中文教程扛把子
🎯 Claude Code（官方编程神器）+ OpenClaw（224K Stars 开源AI助手）= 最强AI工具双教程
📚 22个完整教程 | 130,000+字 | 70+代码示例 | 170+FAQ
⭐ 小白友好 | 从零到企业实战 | 双线学习路径
🔗 GitHub仓库：https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh
老金的开源知识库，实时更新群二维码：https://my.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf
如果这个教程对你有帮助，欢迎打赏支持！
微信支付 |
支付宝 |
这是一套系统化、小白友好、双顶流合璧的 AI 工具中文教程，涵盖两大王者级产品：
| Claude Code | OpenClaw | |
|---|---|---|
| 是什么 | Anthropic 官方 AI 编程 CLI 工具 | 开源 AI 私人助手框架（224K+ Stars） |
| 干什么 | 终端里写代码、调Bug、做架构 | 消息平台上管邮件、排日程、自动化一切 |
| 谁出的 | Anthropic 官方 | Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） |
| 教程数 | 10 篇 + 1 速查卡 | 11 篇完整教程 |
因为它们是 AI Agent 时代的一体两面：
- 血脉相连 — OpenClaw 原名 Clawdbot（Claude + Bot），DNA 里流着 Claude 的血，被 Anthropic 强制改名后依然是 Claude API 最大的社区消费者
- 互补工具链 — Claude Code 管编程工作流，OpenClaw 管日常工作流，合在一起就是程序员的 AI 全家桶
- 中国用户刚需 — 两大顶流 AI 工具的中文教程，一站式搞定，不用东找西找
- 🎓 双线学习路径：Claude Code 编程线 + OpenClaw 助手线，各取所需
- 🚀 快速上手：Claude Code 3 小时上手 / OpenClaw 5 分钟跑起来
- 👶 小白友好：72个术语解释、40个生活类比、170+FAQ
- 💻 实战导向：70+个可运行代码示例，边学边练
- 📊 质量保证：所有教程经 WebSearch 验证，信息准确可靠
- 🔄 持续更新：适配最新版本（Claude Code 2.1.52 / OpenClaw v2026.2.23）
| 序号 | 教程名称 | 学时 | 难度 | 必学度 | 说明 |
|---|---|---|---|---|---|
| 01 | Claude Code完整安装指南 | 2-3h | ⭐ | ⭐⭐⭐ | 环境搭建、API配置、IDE集成 |
| 02 | 基础使用完整指南 | 4-6h | ⭐ | ⭐⭐⭐ | 三种使用模式、30+命令详解 |
| 03 | Commands系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐ | 自定义Slash命令、工作流组合 |
| 04 | MCP集成完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 10+核心服务器、自定义开发 |
| 05 | Hooks系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 8种Hook类型（含Worktree管理）、自动化工作流 |
| 06 | Subagent子代理完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 100+专家代理一键扩展 |
| 07 | Skills定制完整指南 | 6-8h | ⭐⭐ | ⭐⭐ | 创建可复用功能包 |
| 08 | Plugins生态完整指南 | 4-6h | ⭐⭐ | ⭐ | Marketplace浏览与安装 |
| 09 | Agent-SDK完整指南 | 6-8h | ⭐⭐⭐ | ⭐⭐ | 编程开发AI Agent |
| 10 | 综合实战完整指南 | 2-3h | ⭐⭐⭐ | ⭐⭐ | 团队协作、CI/CD集成 |
| 11 | 企业实战完整指南 | 待定 | ⭐⭐⭐ | ⭐ | 企业级最佳实践 |
| 序号 | 教程名称 | 难度 | 说明 |
|---|---|---|---|
| OC-00 | 阅读指南 | 🟢 | 术语表、文档地图、4条阅读路线 |
| OC-01 | 项目介绍 | 🟢 | OpenClaw 是什么、发展历史、核心架构 |
| OC-02 | 安装部署 | 🟢 | macOS / Linux / Windows 全平台安装 |
| OC-03 | 快速开始 | 🟢 | 5 分钟跑起来第一个对话 |
| OC-04 | AI 模型配置 | 🟡 | 接入 OpenAI / Claude / Ollama 等 29 个模型 |
| OC-05 | 消息平台接入 | 🟡 | 连接 WhatsApp / Telegram / Discord / 飞书等 15+ 平台 |
| OC-06 | 技能系统 | 🟡 | 50+ 内置技能详解与自定义技能开发 |
| OC-07 | 记忆系统 | 🟡 | AI 如何记住你的偏好和上下文 |
| OC-08 | 多 Agent 协作 | 🔴 | 一个网关跑多个独立 AI 助手 |
| OC-09 | Docker 部署 | 🔴 | 容器化部署与 VPS 远程访问 |
| OC-10 | 安全配置 | 🔴 | 安全配置、CVE 防护、权限管理 |
| OC-11 | 常见问题 | 🟢 | 踩坑指南与解决方案 |
- 操作系统：Windows 10+、macOS 10.15+、Linux
- Claude API Key：需要有效的 Anthropic API 密钥（或第三方中转站 API Key）
- IDE：VS Code、Cursor、Windsurf 或其他支持的编辑器
⚠️ 2026年更新：Claude Code 已切换到原生安装，不再需要 Node.js！详见安装指南。
- Node.js：22.12.0 或更高版本
- 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-ZhStep 1（60分钟）：01-安装指南 → 路径A快速上手
Step 2（30分钟）：04-MCP集成 → 第2部分快速开始
Step 3（30分钟）：05-Hooks系统 → 第2部分快速开始
完成 ✅ 能用Claude Code + 能用MCP + 能用Hook
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 Agent-SDK + 综合实战
Week 6 ：OpenClaw 安装 + 快速开始 + 模型配置
Week 7 ：OpenClaw 消息平台 + 技能系统 + 记忆系统
Week 8 ：OpenClaw 多Agent + Docker部署 + 安全
| 指标 | 数值 |
|---|---|
| 教程总数 | 22 篇完整教程（Claude Code 10 / OpenClaw 12）+ 1 速查卡 |
| 总字数 | ~130,000 字 |
| 代码示例 | 70+个（全部可运行） |
| FAQ数量 | 170+ 个 |
| 覆盖AI模型 | 29 个提供商（OpenClaw） |
| 覆盖消息平台 | 15+ 个（OpenClaw） |
| Claude Code版本 | 2.1.52（2026-02-25 验证） |
| OpenClaw版本 | v2026.2.23（2026-02-24 验证） |
- ✅ 零基础小白：从未接触过 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 生态做出贡献的开发者和社区成员！
重大更新
- 项目升级为 Claude Code & OpenClaw 双教程
- 仓库更名为
Claude-Code-x-OpenClaw-Guide-Zh - 新增 OpenClaw 11 篇完整中文教程（基于 v2026.2.23）+ 1 篇阅读指南
- 目录结构重组：
docs/claude-code/+docs/openclaw/ - OpenClaw 全部文档经源码验证修正技术错误（配置格式、端口、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 消息平台集成：WhatsApp / Telegram / Discord / 飞书等连接
- OC-06 技能系统：50+ 内置技能详解与自定义技能开发
- OC-07 记忆系统：Markdown 记忆文件、自动刷新、多语言记忆
- OC-08 多 Agent 路由：多 Agent 配置、消息路由、人格设定
- OC-09 Docker 部署：容器化部署、VPS 部署、Fly.io / Render
- OC-10 安全最佳实践：Gateway Token、TLS 1.3、沙箱隔离
- OC-11 常见问题：安装/连接/模型/记忆/性能/中国用户专区
Claude Code 教程补充
- 08-Agent-SDK 新增 3.5 节：Task 工具与子代理编排（子代理类型、DAG 依赖、上下文注入）
- 02-基础使用 /permissions 节新增权限模式切换（plan/acceptEdits/bypassPermissions）和 allowedTools 配置
- 04-MCP集成新增 MCP Apps 交互式界面、工具懒加载 ToolSearch（上下文减少 95%）、远程 MCP 服务器
- README 联系方式新增 X(Twitter) 和微信公众号信息
版本同步更新
- 全部 10 篇教程版本号从 v2.0+ 更新至 v2.1+，验证日期更新至 2026-02-25
- README 版本徽章从 2.1.19 更新至 2.1.52
- 移除 Node.js 环境依赖要求（Claude Code 已切换原生安装）
新增内容
- 05-Hooks教程新增 3.7 节：WorktreeCreate / WorktreeRemove 工作树管理 Hook 详解
- 05-Hooks教程新增
--worktree（-w）内置 Git Worktree 并行任务隔离功能详解（v2.1.49+） - 05-Hooks教程 Hook 类型从 6 种扩展至 8 种，术语表和速查表同步更新
- 02-基础使用新增
--worktree（-w）启动参数说明 - 02-基础使用新增 /fast 快速模式命令说明
- 01-安装指南新增 4.3.1 节：API中转站配置（ANTHROPIC_BASE_URL 环境变量）
修复与优化
- 修复快速导航卡中"安装Node.js"的过时描述，改为"原生安装Claude Code"
- 修复 02-基础使用教程中版本号示例（v2.0.71 → v2.1.52）
- 清理 06/09/10 教程中 23 处 "2.10+/2.1.0+" 旧版本标记
GitHub Issues
- 回复 Issue #5：连接失败排查步骤（HTTPS 代理配置）
- 回复 Issue #2：SQLite MCP 包名验证与替代方案
已完成（原待办项）
- ✅ 08-Agent-SDK 新增 3.5 节：Task 工具与子代理编排（CLI 内置 Subagent 系统）
- ✅ 02-基础使用 /permissions 节新增权限模式切换、allowedTools 配置说明
- ✅ 04-MCP集成 新增 MCP Apps、工具懒加载（v2.1.52+）、远程 MCP 服务器说明
- 10 篇完整 Claude Code 教程，约 104,000 字
- 基于 Claude Code 2.1.19 版本编写
- 70+ 代码示例，120 个 FAQ
- Claude Code 教程基于 2.1.52 版本编写，OpenClaw 教程基于 v2026.2.23 版本编写（持续更新中）
- 部分功能可能随版本更新而变化，请以官方文档为准
- 使用本教程产生的任何问题，作者不承担责任
⭐ 如果这个教程对你有帮助，欢迎 Star 支持！
📢 分享给更多需要的人，让 AI 工具学习更简单！