System Vault

Appearance

00. OpenClaw 文档阅读指南 ​

这份文档是写给谁的？ ​

不管你是刚接触 AI 的小白，还是想深入定制的老手，这套教程都能帮到你。本系列共 12 篇（本篇 00 阅读指南 + 01～11 正文），不必逐篇通读。这篇指南帮你找到最适合自己的阅读路径。

2026-04 版本基线

  • 安装优先级：macOS / Linux / WSL2 下官方更推荐 https://openclaw.ai/install.sh 一键安装，再执行 openclaw onboard
  • Node.js：24.x 推荐，22.14+ 兼容
  • Windows：原生可用，但官方仍明确 WSL2 更稳定
  • 诊断：openclaw doctor 仍然是有效的排障入口
  • 教程与版本号：本轮修订对齐的稳定版参考为 v2026.4.24（2026-04-25 对照 GitHub Releases）。Releases 列表顶部常出现预发布（例如 v2026.4.24-beta.5），与稳定 tag 并存——生产环境请自行选择跟踪哪一条线。文中部分命令仍可能出现较早的 npm install -g openclaw@x.y.z 或 Docker 镜像 tag，仅演示格式；实际安装与升级请以执行时的 npm view openclaw version / latest、镜像 Registry 标签、openclaw --version 及官方 Releases 为准。

术语表（先看这个） ​

在开始之前，先搞懂几个核心概念。后面所有文档都会用到这些词：

术语一句话解释类比
OpenClaw一个开源的 AI 私人助手框架，跑在你自己的电脑上相当于你雇了一个 AI 员工
GatewayOpenClaw 的核心服务进程，负责接收消息、调度 AI、返回回复相当于公司的前台总机
Agent一个独立的 AI 助手实例，有自己的性格、记忆和技能相当于公司里的一个员工
Channel消息平台的连接通道（WhatsApp、Telegram、Discord 等）相当于员工的工位电话
Skill（技能）教 AI 如何完成特定任务的 Markdown 指令文件相当于员工的操作手册
Tool（工具）AI 可以调用的单个功能（读文件、发消息、搜索等）相当于员工手边的工具
Session（会话）你和 AI 的一次对话，包含上下文和历史相当于一次面对面交谈
Memory（记忆）AI 跨会话记住的信息，存储在本地 Markdown 文件中相当于员工的笔记本
DM Pairing（配对）安全机制，新用户首次私聊 AI 时需要你手动批准相当于访客登记制度
Sandbox（沙箱）隔离环境，限制 AI 执行危险操作相当于实验室的安全柜
JSON5OpenClaw 配置文件的格式，比 JSON 多了注释和尾逗号支持相当于更人性化的 JSON
onboardOpenClaw 的初始化引导向导相当于新员工入职培训

文档地图 ​

难度分级说明 ​

  • 🟢 入门 — 零基础也能看懂，跟着做就行
  • 🟡 进阶 — 需要一点技术基础（会用命令行、了解 API 概念）
  • 🔴 高级 — 面向有经验的开发者和运维人员

全部文档一览 ​

序号文档难度一句话说明什么人需要看
01项目介绍🟢 入门OpenClaw 是什么、能干什么、跟别的有什么不同所有人
02安装部署🟢 入门怎么把 OpenClaw 装到你的电脑上所有人
03快速开始🟢 入门5 分钟跑起第一个对话所有人
04模型配置🟡 进阶怎么切换 AI 模型、配置 API Key想换模型的人
05消息平台🟡 进阶怎么把 AI 接到 WhatsApp、Telegram 等平台想在手机上用的人
06技能系统🟡 进阶怎么教 AI 新技能、管理已有技能想定制 AI 能力的人
07记忆系统🟡 进阶怎么让 AI 记住你的偏好和历史想让 AI 更懂你的人
08多Agent协作🔴 高级怎么创建多个 AI 助手分工协作重度用户、团队使用
09Docker部署🔴 高级怎么用 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）

遇到问题怎么办？ ​

  1. 先看 11-常见问题FAQ，80% 的问题都有现成答案
  2. 运行 openclaw doctor 让系统自动诊断
  3. 到 GitHub Issues 搜索或提问
  4. 加入 OpenClaw Discord 社区寻求帮助

文档约定 ​

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

标记含义
🟢 入门零基础可读
🟡 进阶需要一点技术基础
🔴 高级面向有经验的开发者
💡 提示有用的小技巧
⚠️ 注意容易踩的坑
🚫 危险操作不当可能造成数据丢失或安全问题
📖 延伸阅读想深入了解可以看这里
⏭️ 小白可跳过新手不需要看这个章节

Released under the MIT License.

Copyright © 2024-present DANTE FUNG