这份文档是写给谁的?
不管你是刚接触 AI 的小白,还是想深入定制的老手,这套教程都能帮到你。但 11 篇文档加起来上万字,你不需要全部看完。这篇指南帮你找到最适合自己的阅读路径。
术语表(先看这个)
在开始之前,先搞懂几个核心概念。后面所有文档都会用到这些词:
| 术语 | 一句话解释 | 类比 |
|---|---|---|
| OpenClaw | 一个开源的 AI 私人助手框架,跑在你自己的电脑上 | 相当于你雇了一个 AI 员工 |
| Gateway | OpenClaw 的核心服务进程,负责接收消息、调度 AI、返回回复 | 相当于公司的前台总机 |
| Agent | 一个独立的 AI 助手实例,有自己的性格、记忆和技能 | 相当于公司里的一个员工 |
| Channel | 消息平台的连接通道(WhatsApp、Telegram、Discord 等) | 相当于员工的工位电话 |
| Skill(技能) | 教 AI 如何完成特定任务的 Markdown 指令文件 | 相当于员工的操作手册 |
| Tool(工具) | AI 可以调用的单个功能(读文件、发消息、搜索等) | 相当于员工手边的工具 |
| Session(会话) | 你和 AI 的一次对话,包含上下文和历史 | 相当于一次面对面交谈 |
| Memory(记忆) | AI 跨会话记住的信息,存储在本地 Markdown 文件中 | 相当于员工的笔记本 |
| DM Pairing(配对) | 安全机制,新用户首次私聊 AI 时需要你手动批准 | 相当于访客登记制度 |
| Sandbox(沙箱) | 隔离环境,限制 AI 执行危险操作 | 相当于实验室的安全柜 |
| JSON5 | OpenClaw 配置文件的格式,比 JSON 多了注释和尾逗号支持 | 相当于更人性化的 JSON |
| onboard | OpenClaw 的初始化引导向导 | 相当于新员工入职培训 |
文档地图
难度分级说明
- 入门 — 零基础也能看懂,跟着做就行
- 进阶 — 需要一点技术基础(会用命令行、了解 API 概念)
- 高级 — 面向有经验的开发者和运维人员
全部文档一览
| 序号 | 文档 | 难度 | 一句话说明 | 什么人需要看 |
|---|---|---|---|---|
| 01 | 项目介绍 | 入门 | OpenClaw 是什么、能干什么、跟别的有什么不同 | 所有人 |
| 02 | 安装部署 | 入门 | 怎么把 OpenClaw 装到你的电脑上 | 所有人 |
| 03 | 快速开始 | 入门 | 5 分钟跑起第一个对话 | 所有人 |
| 04 | 模型配置 | 进阶 | 怎么切换 AI 模型、配置 API Key | 想换模型的人 |
| 05 | 消息平台 | 进阶 | 怎么把 AI 接到 WhatsApp、Telegram 等平台 | 想在手机上用的人 |
| 06 | 技能系统 | 进阶 | 怎么教 AI 新技能、管理已有技能 | 想定制 AI 能力的人 |
| 07 | 记忆系统 | 进阶 | 怎么让 AI 记住你的偏好和历史 | 想让 AI 更懂你的人 |
| 08 | 多Agent协作 | 高级 | 怎么创建多个 AI 助手分工协作 | 重度用户、团队使用 |
| 09 | Docker部署 | 高级 | 怎么用 Docker 部署到服务器 | 运维人员、服务器部署 |
| 10 | 安全配置 | 高级 | 怎么保护你的 AI 助手不被滥用 | 公网暴露、团队使用 |
| 11 | 常见问题 | 入门 | 遇到问题来这里找答案 | 遇到问题的人 |
阅读路线图
路线一:小白速通(30 分钟上手)
只想最快跑起来?按这个顺序,跳过所有标注"可跳过"的章节:
01-项目介绍(只看前 3 节,了解 OpenClaw 是什么)
↓
02-安装部署(跟着"快速安装"章节操作)
↓
03-快速开始(完整跟着做,5 分钟跑起第一个对话)
↓
搞定!你已经有一个能聊天的 AI 助手了
之后遇到问题去看 11-常见问题FAQ。
路线二:日常使用(2-3 小时)
想在手机上用、想让 AI 更聪明?在路线一的基础上加:
路线一完成后
↓
04-模型配置(选择最适合你的 AI 模型)
↓
05-消息平台(把 AI 接到你的 WhatsApp/Telegram)
↓
06-技能系统(只看"内置技能"和"技能管理"章节)
↓
07-记忆系统(只看"基础配置"章节)
️ 路线三:深度定制(半天到一天)
想玩转所有功能?在路线二的基础上加:
路线二完成后
↓
06-技能系统(完整阅读,学会创建自定义技能)
↓
07-记忆系统(完整阅读,优化记忆策略)
↓
08-多Agent协作(创建专业分工的 AI 团队)
路线四:生产部署(需要运维经验)
要把 OpenClaw 部署到服务器给团队用?
路线二完成后
↓
09-Docker部署(容器化部署到服务器)
↓
10-安全配置(保护你的 AI 助手)
↓
08-多Agent协作(为不同团队成员配置不同 Agent)
遇到问题怎么办?
- 先看 11-常见问题FAQ,80% 的问题都有现成答案
- 运行
openclaw doctor让系统自动诊断 - 到 GitHub Issues 搜索或提问
- 加入 OpenClaw Discord 社区寻求帮助
文档约定
本套文档中使用以下标记:
| 标记 | 含义 |
|---|---|
| 入门 | 零基础可读 |
| 进阶 | 需要一点技术基础 |
| 高级 | 面向有经验的开发者 |
| 提示 | 有用的小技巧 |
| ⚠️ 注意 | 容易踩的坑 |
| 危险 | 操作不当可能造成数据丢失或安全问题 |
| 延伸阅读 | 想深入了解可以看这里 |
| ⏭️ 小白可跳过 | 新手不需要看这个章节 |





京公网安备 11010502044969号