00. OpenClaw 文档阅读指南

课程信息

⠀

作者：老金
GitHub：https://github.com/KimYx0207
公众号：老金带你玩AI
X（Twitter）：老金带你玩AI
个人博客：https://aiking.dev
难度等级：🟢 入门
阅读时间：10 分钟
前置知识：无

⠀

这份文档是写给谁的？

⠀

不管你是刚接触 AI 的小白，还是想深入定制的老手，这套教程都能帮到你。本系列共 12 篇（本篇 00 阅读指南 + 01～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 概念）
🔴 高级 — 面向有经验的开发者和运维人员

⠀

全部文档一览

⠀

序号

文档

难度

一句话说明

什么人需要看

项目介绍

🟢 入门

OpenClaw 是什么、能干什么、跟别的有什么不同

所有人

安装部署

🟢 入门

怎么把 OpenClaw 装到你的电脑上

所有人

快速开始

🟢 入门

5 分钟跑起第一个对话

所有人

模型配置

🟡 进阶

怎么切换 AI 模型、配置 API Key

想换模型的人

消息平台

🟡 进阶

怎么把 AI 接到 WhatsApp、Telegram 等平台

想在手机上用的人

技能系统

🟡 进阶

怎么教 AI 新技能、管理已有技能

想定制 AI 能力的人

记忆系统

🟡 进阶

怎么让 AI 记住你的偏好和历史

想让 AI 更懂你的人

多Agent协作

🔴 高级

怎么创建多个 AI 助手分工协作

重度用户、团队使用

Docker部署

🔴 高级

怎么用 Docker 部署到服务器

运维人员、服务器部署

安全配置

🔴 高级

怎么保护你的 AI 助手不被滥用

公网暴露、团队使用

常见问题

🟢 入门

遇到问题来这里找答案

遇到问题的人

阅读路线图

⠀

🚀 路线一：小白速通（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 社区寻求帮助

文档约定

⠀

本套文档中使用以下标记：

⠀

标记

含义

🟢 入门

零基础可读

🟡 进阶

需要一点技术基础

🔴 高级

面向有经验的开发者

💡 提示

有用的小技巧

⚠️ 注意

容易踩的坑

🚫 危险

操作不当可能造成数据丢失或安全问题

📖 延伸阅读

想深入了解可以看这里

⏭️ 小白可跳过

新手不需要看这个章节