# Claude-Code-x-OpenClaw-Guide-Zh

**Repository Path**: AI-K8S/Claude-Code-x-OpenClaw-Guide-Zh-bak

## Basic Information

- **Project Name**: Claude-Code-x-OpenClaw-Guide-Zh
- **Description**: 从零到企业实战：Claude Code 官方编程神器 + OpenClaw 224K Stars 开源AI助手 | 双顶流中文教程 | 21篇教程 130000+字
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-11
- **Last Updated**: 2026-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code & OpenClaw 中文教程

<div align="center">

![GitHub stars](https://img.shields.io/github/stars/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh?style=social)
![GitHub forks](https://img.shields.io/github/forks/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh?style=social)
![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Claude Code](https://img.shields.io/badge/Claude_Code-2.1.92-green.svg)
![OpenClaw](https://img.shields.io/badge/OpenClaw-v2026.3.28-blue.svg)

**AI 双顶流 · 中文教程扛把子**

</div>

> 🎯 **Claude Code（官方编程神器）+ OpenClaw（开源 AI 助手框架）= 最强 AI 工具双教程**

> 📚 25个完整教程 | 130,000+字 | 70+代码示例 | 170+FAQ

> ⭐ 小白友好 | 从零到企业实战 | 双线学习路径

> 🔗 **GitHub仓库**：[https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh](https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh)


---

## 📖 项目简介

这是一套**系统化、小白友好、双顶流合璧**的 AI 工具中文教程，涵盖两大王者级产品：

| | Claude Code | OpenClaw |
|--|-------------|----------|
| **是什么** | Anthropic 官方 AI 编程 CLI 工具 | 开源 AI 私人助手框架 |
| **干什么** | 终端里写代码、调Bug、做架构 | 消息平台上管邮件、排日程、自动化一切 |
| **谁出的** | Anthropic 官方 | Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） |
| **教程数** | 13 篇 + 1 速查卡 | 12 篇完整教程 |

### 🧬 为什么放在一起？

**因为它们是 AI Agent 时代的一体两面：**

1. **血脉相连** — OpenClaw 原名 **Clawdbot**（Claude + Bot），DNA 里流着 Claude 的血，被 Anthropic 强制改名后依然是 Claude API 最大的社区消费者
2. **互补工具链** — Claude Code 管**编程工作流**，OpenClaw 管**日常工作流**，合在一起就是程序员的 AI 全家桶
3. **中国用户刚需** — 两大顶流 AI 工具的中文教程，一站式搞定，不用东找西找

### ✨ 核心特色

- **🎓 双线学习路径**：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](https://github.com/openclaw/openclaw/releases)）

---

## 📚 教程目录

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

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

**速查**：[Claude Code 快速导航卡](docs/claude-code/快速导航卡.md)

### 🦞 Part 2：OpenClaw — 开源 AI 助手

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

---

## 📋 环境要求

### 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）

---

## 🚀 快速开始

### 克隆仓库

```bash
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](https://github.com/openclaw/openclaw/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 讨论

---


---

## 📋 更新日志

### 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](https://github.com/openclaw/openclaw/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 消息平台集成：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) 和微信公众号信息

### v2.0 (2026-02-25) — 适配 Claude Code 2.1.52

**版本同步更新**
- 全部 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 服务器说明

### v1.0 (2026-02-11) — 初始发布

- 10 篇完整 Claude Code 教程，约 104,000 字
- 基于 Claude Code 2.1.19 版本编写
- 70+ 代码示例，120 个 FAQ

---

## ⚠️ 免责声明

- Claude Code 教程基于 **2.1.92** 编写（[Release](https://github.com/anthropics/claude-code/releases/tag/v2.1.92)）；OpenClaw 教程以 **稳定版 v2026.3.28** 为修订参考，**预发布与 `latest` 以 [Releases](https://github.com/openclaw/openclaw/releases) 与本机 `openclaw --version` 为准**（持续更新中）
- 部分功能可能随版本更新而变化，请以官方文档为准
- 使用本教程产生的任何问题，作者不承担责任