Skip to content

00-阅读指南.md

Latest commit

 

History

History
161 lines (125 loc) · 7.31 KB

00-阅读指南.md

File metadata and controls

161 lines (125 loc) · 7.31 KB

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 仍然是有效的排障入口
  • 教程与版本号：README 徽章中的 OpenClaw v2026.3.28 表示教程修订时对齐的 稳定版 参考（2026-04-05 对照 GitHub Releases）。Releases 列表顶部常出现预发布（例如 v2026.4.1-beta.1），与稳定 tag 并存——生产环境请自行选择跟踪哪一条线。文中部分命令仍可能出现较早的 npm install -g openclaw@x.y.z 或 Docker 镜像 tag，仅演示格式；实际安装与升级请以执行时的 npm view openclaw version / latest、镜像 Registry 标签、openclaw --version 及官方 Releases 为准。

术语表（先看这个）

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

术语 一句话解释 类比
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）

遇到问题怎么办？

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

文档约定

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

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