OpenClaw 教程大纲
每章均有独立文档，点击标题直接阅读。
快速上手
5 分钟内完成安装，开始第一次对话：
- 安装 ：
npm install -g openclaw@latest - 引导 ：
openclaw onboard（交互式完成所有初始配置） - 模型：配置 AI 提供商的 API Key（OpenAI / Claude / Gemini 任选一）
- 渠道：推荐先配置 Telegram Bot（最简单）
- 启动 ：
openclaw gateway - 对话 ：浏览器打开
http://127.0.0.1:18789或在 Telegram 发消息
最小可用配置：
json5
// ~/.openclaw/openclaw.json
{
agents: {
defaults: {
model: { primary: "openai/gpt-5.4" }
}
},
channels: {
telegram: {
enabled: true,
botToken: "your-bot-token",
dmPolicy: "pairing"
}
}
}按目标选择章节：
| 你的目标 | 推荐章节 |
|---|---|
| 刚安装，不知道怎么开始 | [第1章：认识 OpenClaw](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 配置 AI 模型 | [第4章：AI 模型配置](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 接入 Telegram / WhatsApp | [第5章：聊天渠道配置](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 让 AI 记住我的偏好 | [第9章：智能体定制](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 部署到服务器 | [第15章：部署与运维](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 出了问题不知道怎么办 | [附录B：故障排除指南](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
| 查某个命令怎么用 | [附录A：命令参考手册](#你的目标 推荐章节 刚安装，不知道怎么开始 第1章：认识 OpenClaw 配置 AI 模型 第4章：AI 模型配置 接入 Telegram / WhatsApp 第5章：聊天渠道配置 让 AI 记住我的偏好 第9章：智能体定制 部署到服务器 第15章：部署与运维 出了问题不知道怎么办 附录B：故障排除指南 查某个命令怎么用 附录A：命令参考手册) |
第一部分：入门篇
第1章：认识 OpenClaw
- 1.1 什么是 OpenClaw
- 1.2 核心概念与架构
- 1.3 功能特性概览
- 1.4 适用场景与优势
第2章：环境准备
- 2.1 系统要求
- 2.2 Node.js 安装与配置
- 2.3 包管理器选择（npm/pnpm/bun）
- 2.4 网络环境准备
第3章：安装与初始化
- 3.1 安装 OpenClaw CLI
- 3.2 运行新手引导（onboard）
- 3.3 配置文件结构解析
- 3.4 工作区目录说明
第二部分：核心配置篇
第4章：AI 模型配置
- 4.1 模型提供商概览
- 4.2 OpenAI 配置详解
- 4.3 Anthropic Claude 配置
- 4.4 Google Gemini 配置
- 4.5 其他模型提供商
- 4.6 模型选择与回退策略
- 4.7 模型用量监控
第5章：聊天渠道配置
- 5.1 渠道概览与选择建议
- 5.2 Telegram 配置（推荐新手）
- 5.3 WhatsApp 配置
- 5.4 Discord 配置
- 5.5 其他渠道配置
- 5.6 渠道安全设置
- 5.7 群组与私信策略
第6章：Gateway 网关管理
- 6.1 Gateway 架构与工作原理
- 6.2 前台运行 vs 后台服务
- 6.3 端口配置与网络绑定
- 6.4 认证与安全设置
- 6.5 日志管理与监控
- 6.6 故障诊断与恢复
第三部分：使用篇
第7章：开始对话
- 7.1 Web 界面使用
- 7.2 聊天应用对话
- 7.3 CLI 命令行交互
- 7.4 会话管理
- 7.5 上下文理解与记忆
第8章：高级对话功能
- 8.1 命令系统（/status, /model, /config 等）
- 8.2 多模态交互（图片、语音、文件）
- 8.3 群组对话管理
- 8.4 个性化设置
- 8.5 对话历史与检索
第9章：智能体定制
- 9.1 AGENTS.md 配置
- 9.2 SOUL.md 人设定义
- 9.3 TOOLS.md 工具说明
- 9.4 BOOTSTRAP.md 初始化
- 9.5 IDENTITY.md 身份标识
第四部分：进阶功能篇
第10章：多智能体管理
- 10.1 智能体概念与隔离
- 10.2 创建与配置智能体
- 10.3 智能体路由策略
- 10.4 每智能体安全配置
第11章：Skills 扩展系统
- 11.1 Skills 概念与工作机制
- 11.2 安装与管理 Skills
- 11.3 常用 Skills 介绍
- 11.4 自定义 Skills 开发
第12章：自动化与定时任务
- 12.1 定时任务概览
- 12.2 创建定时任务
- 12.3 管理定时任务
- 12.4 自动化工作流设计
第13章：节点系统
- 13.1 节点概念与用途
- 13.2 移动设备配对（iOS/Android）
- 13.3 无头节点部署
- 13.4 Canvas 与屏幕控制
- 13.5 相机与位置服务
第14章：浏览器自动化
- 14.1 Browser 工具介绍
- 14.2 快速开始
- 14.3 网页操作基础
- 14.4 Chrome 扩展中继
- 14.5 常见自动化场景
第五部分：运维与安全篇
第15章：部署与运维
- 15.1 本地部署
- 15.2 服务器部署
- 15.3 Docker 部署
- 15.4 云服务部署
- 15.5 性能优化
- 15.6 备份与恢复
第16章：远程访问
- 16.1 远程访问方案对比
- 16.2 Tailscale 组网（推荐）
- 16.3 SSH 隧道配置
- 16.4 TLS 与证书配置
- 16.5 网络安全策略
第17章：安全管理
- 17.1 认证与授权机制
- 17.2 访问控制策略
- 17.3 工具权限控制
- 17.4 沙箱隔离
- 17.5 安全审计
第18章：监控与诊断
- 18.1 系统状态监控
- 18.2 日志分析
- 18.3 性能指标追踪
- 18.4 故障排查流程
- 18.5 健康检查工具
第六部分：开发与扩展篇
第19章：插件开发
- 19.1 插件架构概述
- 19.2 开发环境搭建
- 19.3 插件生命周期
- 19.4 核心 API 使用
- 19.5 发布插件
第20章：自定义工具开发
- 20.1 工具系统架构
- 20.2 工具开发基础
- 20.3 工具安全实践
- 20.4 工具测试与性能优化
第21章：API 集成
- 21.1 Gateway RPC 协议
- 21.2 WebSocket 客户端示例
- 21.3 第三方服务集成
- 21.4 API 安全实践
第七部分：实战案例篇
第22章：个人助理场景
- 22.1 日常任务管理
- 22.2 信息查询助手
- 22.3 学习辅导工具
- 22.4 生活提醒系统
第23章：开发辅助场景
- 23.1 代码编写助手
- 23.2 技术文档生成
- 23.3 Bug 分析与修复
- 23.4 项目管理协作
第24章：商业应用场景
- 24.1 客服机器人
- 24.2 数据分析助手
- 24.3 内容创作工具
- 24.4 流程自动化
第25章：创意娱乐场景
- 25.1 游戏辅助工具
- 25.2 创意写作伙伴
- 25.3 多媒体内容生成
- 25.4 社交互动增强