> 📖 **纸质书《OpenClaw超级个体实操手册》已上市！** 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。🛒 [京东专属购买链接（¥42，原价¥59.8）](https://item.jd.com/14669463.html)

# 第1章：认识OpenClaw

> 在开始使用 OpenClaw之前，先了解它是什么，为什么要用它，以及它能带来什么。

> ⚠️ **版本说明**：截至 **2026-09-10**，本教程按 **OpenClaw v2026.9.3（稳定版，2026-09-08 发布）** 校对。升级自 2026.6.x / 2026.8.x 后请先跑 `openclaw doctor --fix`。

> 💡 **重要前提**：OpenClaw 现在的主线能力不只来自 Skills，还包括官方内建的记忆系统、Task Flow、媒体生成工具、Webhooks 和 `infer` CLI。教程中凡是遇到“第三方 Skill 安装失败”或“命令找不到”，优先按官方主路线排查。

---

## 1.1 什么是OpenClaw

![OpenClaw Logo - 开源AI智能体网关](https://upload.maynor1024.live/file/1770806852123_openclaw-logo-text-dark.png)

### 一句话介绍

OpenClaw 是一个**开源的 AI 智能体 Gateway 网关**，让你可以在本地部署 AI 助手，访问本地文件，通过多个平台（飞书、企微、QQ等）随时使用。

> **项目名称演变**：OpenClaw 原名 Clawdbot，因 Anthropic 商标顾虑在 2026年1月27日更名为 Moltbot（过渡名），最终在1月30日确定为 OpenClaw。三个名字本质是同一个项目，功能完全一致。

### 核心能力

- 🏠 **本地/云端部署**：在你的电脑或服务器上运行，数据和配置可控
- 📁 **文件与工作区操作**：可以搜索、读取、编辑本地文件并执行自动化任务
- 🧠 **记忆系统升级**：支持 Active Memory、Dreaming、Memory Wiki 等长期记忆能力
- ⚙️ **自动化主线**：除了定时任务，还支持 Task Flow 和 Webhooks 驱动的持久化流程
- 🎬 **媒体生成内建化**：官方支持图片、视频、音乐生成以及 ComfyUI 工作流接入
- 💬 **多平台使用**：支持飞书、企微、钉钉、QQ、Telegram、Discord 等
- 💰 **成本可控**：使用自己的 API 或本地能力，自行控制成本与安全边界

### 2026.4 → 2026.9 你需要知道的主线

> 下列能力从 2026.4 起进入主线；**2026.8.1（OpenClaw 2.0）** 与 **v2026.9.3** 又叠加了会话 SQLite、OpenAI 路由规范化和更新恢复等变化。跑教程前先确认 `npm view openclaw version` = `2026.9.3`。

#### 仍在用的核心能力

- **Active Memory**：在主回复前自动回忆用户偏好、上下文和历史细节
- **Dreaming**：通过 light / deep / REM 三阶段，把高价值短期信息提升为长期记忆
- **Memory Wiki**：把知识库从“普通笔记”升级为带 `claim / evidence`、矛盾检测和新鲜度排序的结构化知识层
- **Task Flow + Webhooks**：把自动化从“定时触发”扩展为“可恢复、可追踪、可被外部系统驱动”的工作流
- **`openclaw infer`**：统一模型、图片、音频、TTS、视频、网页搜索和 embedding 的 CLI 入口
- **Control UI 多语言**：当前官方已支持简中、繁中、日语、韩语、法语、德语、西语等多语言界面

#### 升级到 v2026.9.3 还要记住
- **Node**：`>=24.16.0 <25 || >=26.1.0`（推荐 Node 26）
- **迁移**：`openclaw doctor --fix`（`openai/*` 路由、OpenProse 清理、Workshop 归属等）
- **不要再默认推荐**：`openai-codex/*`、`/prose`、整串 `clawhub install …`

### 工作原理

![OpenClaw 工作原理 - Gateway网关连接聊天应用和AI智能体](https://upload.maynor1024.live/file/1770956386804_nanobananapro-de8b9c6e-4c15-4267-b112-5b22b2435209-0__2_.png)

OpenClaw 通过 Gateway 网关将聊天应用连接到 AI 智能体。Gateway 是会话、路由和渠道连接的**唯一事实来源**。

**核心组件：**

1. **Gateway 网关**
   - 连接各个聊天平台（飞书、企微、QQ、Telegram等）
   - 管理会话和消息路由
   - 默认地址：`http://127.0.0.1:18789/`
   - 配置文件：`~/.openclaw/openclaw.json`

2. **AI 智能体**
   - 支持 Claude、GPT、Gemini、DeepSeek、Kimi 等多种模型
   - 可以本地运行或远程调用

3. **Skills 技能系统**
   - 文件管理、知识管理、自动化等
   - 可自定义开发

4. **ClawHub**
   - 技能市场，可以下载和分享 Skills

> 💡 **Gateway 网关是什么？**  
> Gateway 是 OpenClaw 的核心服务，它像一个"中央调度站"，负责：
> - 接收来自不同平台的消息（飞书、企微、QQ、Telegram等）
> - 将消息转发给 AI 智能体处理
> - 把 AI 的回复发送回对应平台
> - 管理所有的会话和上下文
> 
> 这就是为什么你可以在任何平台上使用 OpenClaw，因为 Gateway 统一管理了所有的连接。

![Gateway 工作流程 - 消息路由和会话管理](https://upload.maynor1024.live/file/1770956080282_nanobananapro-de8b9c6e-4c15-4267-b112-5b22b2435209-0.png)

---

## 1.2 为什么选择OpenClaw

### 与在线AI的本质区别

OpenClaw 与传统在线 AI 服务在部署方式、数据隐私和功能扩展等方面存在本质差异，如表 1-3 所示。

**表 1-3 OpenClaw 与在线 AI 对比**

| 特性 | OpenClaw | ChatGPT/Claude网页版 |
|------|----------|---------------------|
| 部署方式 | 本地/云端 | 在线服务 |
| 数据隐私 | ✅ 完全掌控 | ⚠️ 上传到服务器 |
| 本地文件访问 | ✅ 支持 | ❌ 不支持 |
| 系统操作 | ✅ 支持 | ❌ 不支持 |
| 功能扩展 | ✅ Skills系统 | ❌ 固定功能 |
| 成本 | 按需付费 | 订阅制 |
| 多平台集成 | ✅ 支持 | ⚠️ 有限 |

**简单来说**：
- ChatGPT/Claude：像在网吧上网，方便但受限
- OpenClaw：像自己的电脑，自由但需要配置

### 五大核心优势

#### 1. 本地部署，保护隐私

**场景**：你需要AI帮你整理公司的财务报表

- ❌ **在线AI**：需要上传文件到服务器，存在泄密风险
- ✅ **OpenClaw**：文件不离开你的电脑，完全安全

#### 2. 访问本地文件和系统

**场景**：你想找一张去年的发票

- ❌ **在线AI**：无法访问你的电脑，只能手动找
- ✅ **OpenClaw**：直接搜索电脑上的所有文件，秒找到

**真实案例**：
我：帮我找一下我电脑上的一张发票，里面详情是买了一个跑步机
OpenClaw：[搜索中...] 找到了！这是您的跑步机发票 [发送文件]


#### 3. 可扩展的Skills生态

**场景**：你想让AI帮你画图

- ❌ **在线AI**：功能固定，不支持就没办法
- ✅ **OpenClaw**：安装 Banana Skills，立即支持画图

**可用的Skills**：
- 文件管理：智能搜索、批量处理、自动整理
- 知识管理：网页剪藏、笔记同步、论文管理
- 日程管理：日历同步、智能提醒
- 自动化：定时任务、网站监控、日报推送
- 工具类：截图、翻译、画图、视频生成

#### 4. 多平台支持

**场景**：你在外面，想让AI帮你处理文件

- ❌ **在线AI**：需要打开网页，操作不便
- ✅ **OpenClaw**：打开飞书/企微/QQ，直接发消息

**支持的平台**：
- 🏢 **企业微信**：团队协作
- 📱 **钉钉**：办公自动化
- 🚀 **飞书**：项目管理
- 💬 **QQ**：个人助手
- 🌐 **Telegram/Discord**：国际平台

#### 5. 成本可控

**场景**：你担心AI使用费用太高

- ❌ **ChatGPT Plus**：20美元/月，固定费用
- ✅ **OpenClaw**：按需付费，用多少花多少

**成本对比**（月使用量：中等）：
- ChatGPT Plus：20美元（约140元）
- Claude Pro：20美元（约140元）
- OpenClaw + DeepSeek：5-30元
- OpenClaw + Kimi：10-50元

💡 **省钱技巧**：使用国产大模型可以节省50%-70%成本

![真实用户案例 - 内容创作者的效率提升之路](https://upload.maynor1024.live/file/1770956135054_nanobananapro-f4cf9d4d-92b3-4ce5-a2ce-b38e5873b2d4-0__1_.png)

---

## 1.3 OpenClaw vs 主流AI工具

OpenClaw 与主流 AI 工具在功能定位和成本结构上存在显著差异。下面从核心功能、成本和适用人群三个维度进行详细对比。

#### 核心功能对比

OpenClaw 在本地文件访问、系统操作和自动化任务方面具有明显优势，如表 1-1 所示。

**表 1-1 主流 AI 工具功能对比**

| 功能特性 | OpenClaw | ChatGPT Plus | Cursor | Claude Pro |
|---------|----------|--------------|--------|------------|
| **本地文件访问** | ✅ 完整支持 | ❌ 不支持 | ✅ 支持 | ❌ 不支持 |
| **系统操作** | ✅ 日历/备忘录/截图 | ❌ 不支持 | ⚠️ 有限 | ❌ 不支持 |
| **多平台集成** | ✅ 飞书/企微/钉钉/QQ | ⚠️ 有限 | ❌ 不支持 | ⚠️ 有限 |
| **Skills扩展** | ✅ 1715+ | ❌ 不支持 | ⚠️ 插件 | ❌ 不支持 |
| **多模型切换** | ✅ 随意切换 | ❌ 固定GPT | ✅ 支持 | ❌ 固定Claude |
| **代码能力** | ✅ 强 | ⚠️ 中等 | ✅ 强 | ✅ 强 |
| **自动化任务** | ✅ 完整支持 | ❌ 不支持 | ❌ 不支持 | ❌ 不支持 |

#### 成本对比

OpenClaw 采用按量付费模式，相比固定月费的在线服务可节省 73%-96% 的成本，如表 1-2 所示。

**表 1-2 年度成本对比**

| 项目 | OpenClaw | ChatGPT Plus | Cursor | Claude Pro |
|------|----------|--------------|--------|------------|
| **月费** | 5-50元 | 140元 | 140元 | 140元 |
| **年费** | 60-600元 | 1680元 | 1680元 | 1680元 |
| **节省** | - | 节省73%-96% | 节省73%-96% | 节省73%-96% |
| **计费方式** | 按量付费 | 固定月费 | 固定月费 | 固定月费 |

**成本说明**：
- OpenClaw 成本 = 服务器费用（可选）+ API 费用
- 本地部署：0元服务器 + 5-30元 API = 5-30元/月
- 云端部署：20元服务器 + 5-30元 API = 25-50元/月

#### 适合人群

✅ **强烈推荐OpenClaw的人群**：
1. **超级个体/自由职业者** - 需要一个人顶一个团队
2. **知识工作者** - 需要管理大量文档和知识
3. **程序员** - 需要代码辅助和自动化
4. **内容创作者** - 需要素材管理和多平台发布
5. **注重隐私** - 不想上传敏感文件到云端
6. **成本敏感** - 想要高性价比的AI助手

⚠️ **如果你只需要简单对话，可以考虑**：
- ChatGPT Plus：最简单，开箱即用
- Claude Pro：长文本处理能力强

💡 **最佳方案**：
- 日常对话：ChatGPT/Claude
- 工作助手：OpenClaw（本地文件、自动化、多平台）
- 代码编写：Cursor + OpenClaw

### 真实案例：为什么我选择OpenClaw

> 我是一个内容创作者，每天需要：
> - 整理大量的资料和文章
> - 管理日程和任务
> - 生成图片和视频
> - 多平台发布内容
>
> 以前我需要：
> - ChatGPT：写文案
> - Notion：管理笔记
> - Midjourney：画图
> - 各种工具：自动化
>
> 现在只需要OpenClaw：
> - 一个助手搞定所有事情
> - 成本降低70%
> - 效率提升10倍

![OpenClaw 多场景应用示意图 - 覆盖工作生活各个方面](https://upload.maynor1024.live/file/1771037222148_nanobananapro-de8b9c6e-4c15-4267-b112-5b22b2435209-0.png)

---

## 1.4 适用场景

### ✅ 适合使用 OpenClaw的场景

#### 1. 个人效率提升

**知识工作者**：
- 整理大量文档和资料
- 管理日程和任务
- 自动化重复工作

**程序员**：
- 代码搜索和管理
- 技术文档整理
- 开发环境管理

**内容创作者**：
- 资料收集和整理
- 内容创作辅助
- 多平台发布

**学生**：
- 课程资料管理
- 论文阅读和笔记
- 学习计划管理

#### 2. 知识管理

- 网页文章存档
- GitHub项目管理
- 论文笔记整理
- 跨设备同步

#### 3. 编程开发

- 代码搜索和理解
- 技术文档查询
- 开发环境配置
- 项目管理

#### 4. 团队协作

- 项目管理自动化
- 文档协作优化
- 会议记录整理
- 团队知识库建设

#### 5. 创意工作

- AI绘画工作流
- 视频脚本生成
- 多语言翻译
- 数据分析自动化

### ❌ 不适合使用 OpenClaw的场景

#### 1. 纯在线对话

如果你只是想偶尔和AI对话，不需要访问本地文件：
- ChatGPT网页版更方便
- 无需安装配置
- 打开就能用

#### 2. 专业代码编辑

如果你只需要代码补全和编辑：
- Cursor更专业
- GitHub Copilot更方便
- 集成度更高

#### 3. 移动端为主

如果你主要在手机上使用：
- ChatGPT App更方便
- Claude App更流畅
- 无需配置

#### 4. 不想折腾

如果你：
- 不想学习新工具
- 不想配置环境
- 只想开箱即用

那么在线AI服务更适合你。

### 💡 最佳实践

**推荐组合**：
1. **OpenClaw**：日常工作助手
2. **Cursor**：代码编辑
3. **ChatGPT**：移动端对话

**使用建议**：
- 在电脑上：优先使用 OpenClaw
- 写代码时：使用Cursor
- 在外面时：使用ChatGPT App

![AI工具能力对比雷达图 - OpenClaw在任务规划和自动化方面的优势](https://upload.maynor1024.live/file/1770956241802_nanobananapro-de8b9c6e-4c15-4267-b112-5b22b2435209-0__1_.png)

---

## 1.5 OpenClaw vs 其他AI工具能力对比

不同 AI 工具在任务规划、自动执行、代码质量等维度上各有侧重。OpenClaw 在任务规划和自动化方面表现突出，如表 1-4 所示。

**表 1-4 AI 工具能力维度对比**

| 能力维度 | OpenClaw | Claude Code | Cursor | ChatGPT |
|---------|----------|-------------|--------|---------|
| 任务规划 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| 自动执行 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 自我修复 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐ |
| 工程级操作 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
| 本地自动化 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐ |
| 代码质量 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 易用性 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

**核心差异：**
- **OpenClaw**：强在任务规划和自动执行完整工程流程
- **Claude Code/Cursor**：强在代码质量与理解
- **ChatGPT**：强在对话体验和易用性



---

## 本章小结

通过本章，你应该了解了：

✅ **OpenClaw是什么**：本地AI助手，通过Gateway连接多个平台  
✅ **核心优势**：本地部署、文件访问、可扩展、多平台、成本低  
✅ **与其他AI的区别**：更适合作为个人工作助手  
✅ **适用场景**：效率提升、知识管理、编程开发、团队协作  
✅ **不适合场景**：纯对话、移动端为主、不想折腾

## 思考题

1. 你目前使用什么AI工具？遇到了什么问题？
2. OpenClaw的哪个功能最吸引你？
3. 你打算用OpenClaw做什么？

---

**下一章**：[第2章：环境搭建](02-installation.md) - 5分钟完成安装

**返回目录**：[README](../../README.md)

---

## 🌐 在线阅读

📖 **想在线阅读此章节？**

[🔗 在线阅读：第1章 - OpenClaw是什么？](https://awesome.tryopenclaw.asia/docs/01-basics/01-introduction/)

访问网站获取更好的阅读体验：
- 📱 响应式设计，支持手机、平板、电脑
- 🌙 支持黑暗模式，保护眼睛
- 🔍 内置搜索功能，快速定位内容
- 📋 目录导航，轻松跳转章节

[🏠 访问完整教程网站](https://awesome.tryopenclaw.asia)
