OpenClaw 系统学习训练营
iKevin系统 · 全套 21 节课完整讲义
6 大模块
21 节课
从入门到实战
课程总览
01
模块一：认知与环境准备
第 1–3 课：了解 OpenClaw 定位、安装前置工具、掌握命令行基础
02
模块二：本地安装与配置
第 4–7 课：跨平台安装、初始化、配置文件深入、Gateway 管理
03
模块三：核心功能与基础使用
第 8–11 课：Dashboard 操作、文件管理、浏览器自动化、定时任务
04
模块四：Skills 开发与扩展
第 12–15 课：内置技能调用、自定义 Skill 基础/进阶/高级开发
05
模块五：服务器部署与运维
第 16–18 课：远程部署、24 小时稳定运行、安全配置与排查
06
模块六：综合实战与落地
第 19–21 课：办公自动化助手、数据采集系统、课程总结与进阶
模块一
认知与环境准备
帮助学员正确认识 OpenClaw 在 AI 智能体领域的定位，解决开工前的环境准备与命令行基础，确保后续实操不再因环境问题频繁卡顿。
第 1 课：OpenClaw 是什么？AI 智能体入门
课程目标
建立清晰认知：了解 OpenClaw 是什么、解决什么问题、与普通聊天 AI 的区别，以及学习价值所在。形成后续学习的整体框架。
适合对象
对智能体零基础的学员；曾使用 ChatGPT 等产品但未接触 Agent 系统的人员；希望将 AI 从"问答工具"升级为"执行助手"的职场人士。
核心知识点
  • AI 发展阶段：从文本生成到智能体执行
  • OpenClaw 的定义、核心组成和能力边界
  • 应用场景：文件操作、浏览器控制、自动化工作流、Skill 扩展
  • 智能体与普通对话模型的区别
  • OpenClaw 的局限：并非万能，不可替代人类决策
  • 系统学习的重要性：理解架构而不仅仅是安装说明
AI 的演化：从聊天助手到智能体
1
生成阶段
提问、翻译、写作等，大语言模型最初的用法
2
辅助阶段
代码编写、文档整理、表格分析，但仍停留在回答层面
3
执行阶段
打开网页、抓取数据、定时执行流程，驱动智能体形态出现

核心问题：为什么需要在人工智能中增加"手、眼、腿"？OpenClaw 正是这一答案。
OpenClaw 五层架构
模型层
大语言模型推理能力
网关层
请求路由与任务调度
Dashboard
可视化交互控制面板
工具层
文件、浏览器等执行工具
扩展层
Skill 插件与外部 API
OpenClaw 能做什么 vs 不能做什么
✅ 能做的事
  • 文件处理：读写文本、批量整理、信息提取与归档
  • 浏览器自动化：打开网页、元素定位、点击输入、抓取数据
  • 自动化工作流：定时日报、监控网页变化、同步文件
  • Skill 扩展：连接外部 API、企业系统、第三方服务
❌ 不能做的事
  • 不是自动赚钱机器，效果取决于配置合理性和任务清晰度
  • 无法完全替代人工，复杂决策和责任承担仍需人类
  • 不能在环境不稳定或流程不清晰时可靠运行
  • 避免"装了工具就万事大吉"的误区
类比：聊天 AI 是"顾问"，OpenClaw 更像"执行助理"，两者互为补充。
第 2 课：环境要求与前置工具安装
终端 / Shell
运行命令和管理环境的入口。Windows: CMD/PowerShell；macOS: Terminal；Linux: Bash/zsh
Node.js + 包管理器
运行 JavaScript/TypeScript 的环境。配合 npm、pnpm 或 yarn 管理依赖库
Git
拉取代码仓库和版本管理，开源生态不可或缺的工具
浏览器 + 编辑器
支撑网页自动化功能；推荐 VS Code 等现代编辑器查看配置和日志

安装前检查清单：系统版本、终端可用性、Node 版本、包管理器版本、Git 版本、浏览器配置、管理员权限、网络状态。
环境变量与常见安装问题
环境变量 PATH
PATH 是系统的"配置纸条"，告诉系统哪里找可执行程序。设置错误会导致"命令不存在"报错。
验证命令：node -v · npm -v · pnpm -v · git --version
常见安装问题
  • 命令找不到：PATH 不正确或未打开新终端
  • 多版本冲突：新手应避免多个 Node 版本共存
  • 包管理器混用：跟随官方推荐，避免锁文件冲突
  • 权限不足：公司电脑可能阻止写入和安装
  • 网络下载失败：可切换镜像或检查代理设置
第 3 课：命令行基础与 OpenClaw 前置准备
克服对命令行的恐惧，掌握终端、Shell、路径与目录等基本概念，能顺利进入项目目录并执行命令。
必备命令速查
1
定位与浏览
pwd 查看当前目录 · ls / dir 列出内容 · cd <目录> 进入目录 · cd .. 返回上级
2
文件管理
mkdir 创建目录 · touch 创建文件 · cp 复制 · mv 移动/重命名 · rm 删除（不可恢复！）
3
查看内容与日志
cat 查看全文 · less 分屏查看 · tail -f 实时查看日志尾部
4
有效求助模板
系统信息 + 执行命令 + 所在目录 + 完整报错 + 已尝试操作 + 预期目标
模块二
本地安装与基础配置
引导学员完成 OpenClaw 的正式安装、初始化与配置，解决"装上了跑不起来"的痛点，学会管理网关进程，为后续使用和开发打好基础。
第 4 课：OpenClaw 一键安装
（Windows / macOS / Linux）
Windows
PowerShell/Git Bash 克隆源码 → pnpm install → 执行安装脚本。注意：管理员权限运行、防火墙弹窗、路径无空格
macOS
Terminal + Git 拉取项目 → Homebrew 安装依赖 → pnpm install。注意：避免旧版 Node 冲突，安装目录需在用户权限区域
Linux
git clone + apt/yum 安装 Node → pnpm install。注意：缺少编译工具链、sudo 谨慎使用、端口占用
安装完成后：运行启动命令 → 确认终端无明显错误 → 打开 Dashboard 验证页面正常显示。
第 5 课：首次初始化与快速配置
初始化流程
运行 pnpm run init，系统将生成配置文件、创建缓存目录、下载必要模型。
模型与凭证配置
在 openclaw.config.json 或 .env 文件中填入 API Key。注意：密钥加入忽略列表，避免泄露。支持主模型与 fallback 备用模型切换机制。
快速配置项
  • 默认模型与最大输入长度
  • 超时设置与端口号
  • 日志等级与存储路径
  • 文件系统访问路径
Dashboard 访问
浏览器打开 http://localhost:18800，发送第一条指令，观察模型回复与任务状态。
第 6 课：配置文件深入与自定义设置
模型配置与路由
models 字段：模型名称、供应商、API Key、使用限制。配置主模型与 fallback 切换逻辑，可为不同任务指定不同模型。
文件系统与安全
filesystem 字段：允许访问的根路径、默认读写目录、禁止访问路径。设置只读目录和沙盒隔离，防止误操作系统级文件。
日志与监控
logging 字段：日志等级（debug/info/warn/error）、输出位置、存储目录。配置按日期或文件大小自动轮转，防止日志占满磁盘。
服务与性能
server 字段：端口号、HTTPS、跨域配置。并发设置：最大并发任务数、超时时间、内存限制、网络代理设置。
第 7 课：Gateway 管理与基础命令速查
启动 / 停止
pnpm run start / pnpm run stop。后台运行：使用 nohup、& 或 Windows 服务
状态检查
ps、pgrep、systemctl status（Linux）或任务管理器（Windows）
日志查看
tail -f 实时查看。日志字段：时间戳、日志等级、来源模块、具体消息
端口监控
lsof -i :<端口>（macOS/Linux）或 netstat -ano | findstr <端口>（Windows）
自动重启
Linux: systemd / pm2 / supervisord；Windows: 计划任务或服务管理
模块三
核心功能与基础使用
聚焦于 OpenClaw 的核心操作：Dashboard 交互、本地文件处理、浏览器控制，以及定时任务与自动化工作流。通过实践，真正体会 OpenClaw 的生产力优势。
第 8 课：Web Dashboard 使用与交互
界面结构
浏览器访问 http://localhost:18800。布局：左侧会话栏、右侧消息区、顶部导航栏、设置区域。支持深色模式与语言切换。
会话管理
创建新会话、查看历史记录、命名/删除/归档会话。不同会话使用独立上下文。
任务状态
  • Pending：等待执行
  • Running：执行中
  • Finished：完成
  • Failed：失败
文件上传与模型切换
支持上传文档、表格、图片供智能体使用。可在设置中切换模型（OpenAI / Anthropic / 自定义），不同模型响应速度、成本和功能有差异。
第 9 课：本地文件管理与数据操作
创建与读取文件
通过指令创建文件并写入内容；支持全文读取或部分读取（如读取前 N 行）；上传文件后可解析总结。
目录遍历与搜索
列出目录下所有文件并筛选扩展名；递归遍历整个目录树；结合正则表达式搜索文件内容。
批量处理与数据提取
对多个文件执行同一操作：去除前缀、合并内容、生成摘要表；提取关键词、日期或特定模式并输出到新文件。

安全提示：执行删除或批量写入操作前务必备份数据；在配置文件中限制可操作目录，防止误删敏感数据。
第 10 课：浏览器自动化与网页操作
1
页面元素定位
常用方法：ID、class、tag、CSS 选择器、XPath。通过浏览器开发者工具获取元素路径。
2
基础操作命令
打开网页、点击元素、输入文本、滚动页面、等待加载（处理异步渲染）。
3
数据抓取与流程组合
提取文本、链接、图片；循环遍历列表；完整流程：登录 → 搜索 → 翻页抓取 → 汇总输出。
第 11 课：定时任务与自动化工作流
Cron 表达式基础
字段：分钟 · 小时 · 日期 · 月份 · 星期
示例：0 9 * * * = 每天早上 9 点执行
常见自动化场景
  • 日报生成：读取日志生成摘要并发送邮件
  • 数据同步：定期抓取网站数据写入本地
  • 监控告警：检查磁盘/服务状态，异常时通知
  • 文件整理：定期分类整理下载文件夹
工作流设计要点
  • 定义任务链：指定前置和后置任务
  • 设置重试次数、超时和并发限制
  • 日志记录：用于审计和排查
  • 通知渠道：邮件、Slack 或短信
  • 避免过于频繁的任务占满资源

自动化是提高效率的终极武器，让 OpenClaw 主动帮你执行周期性任务。
模块四
Skills 开发与扩展
Skills 是 OpenClaw 的核心扩展单元。通过内置技能快速调用各种功能，通过自定义技能开发连接外部 API 和企业系统，真正让智能体服务于你的业务需求。
第 12 课：Skills 体系与内置技能使用
文件操作类
read_file、write_file 等，用于读写本地文件和目录操作
网络请求类
http_request 等，用于调用外部 API 获取数据
浏览器控制类
browser_open_url 等，用于自动化网页操作和数据抓取
数据处理类
用于格式转换、内容提取、结构化输出等数据处理任务
Skill 生命周期：被调用 → 执行任务 → 返回结果 → 结果输入模型。技能调用比纯自然语言指令更可靠、可控，适合执行具体操作。
第 13 课：自定义 Skills 开发基础（JavaScript）
Skill 基础结构
目录：skills/your_skill/
包含：index.js（或 index.ts）、package.json、README.md
必要字段：name（技能名称）、description（描述）、parameters（参数定义）、handler（主逻辑函数）
开发流程
  1. 搭建开发目录，初始化 package.json
  1. 编写处理逻辑：引入模块、处理异常、返回结果
  1. 本地独立测试：Node.js 运行并传入模拟参数
  1. 将 Skill 文件复制到 OpenClaw 的 skills 目录
  1. 在配置文件中注册名称，重启网关使其生效
第 14 课：自定义 Skills 开发进阶
调用 RESTful API 与 MCP 协议
RESTful API 调用
使用 fetch、axios 或 node-fetch 发起 HTTP 请求。支持 GET/POST/PUT/DELETE 方法，处理 API Key、Bearer Token、Basic Auth 等认证方式。
响应解析与错误处理
解析 JSON 数据、验证字段、提取有效信息。处理超时、网络错误或非 200 返回码，设计重试机制。
MCP 协议简介
Message Passing Protocol 用于模块间通信或与其他智能体交互。注重消息传递、订阅发布模式，适合实时通信或内部组件交互。
异步与并发控制
使用 async/await 和 Promise 处理异步操作。限制并发数量、设置超时、取消请求，确保技能稳定性。

安全提示：将 API Key 存储在环境变量或 .env 文件中，绝不硬编码到代码仓库。
第 15 课：自定义 Skills 开发高级
流程控制
条件分支（if/else/switch）根据输入决定执行路径；任务分解为多个子任务
循环与批处理
for/forEach/while 处理数组；顺序或并发执行多个异步任务；批量下载或查询
异常处理与容错
try/catch 捕获错误；自动重试机制；根据错误类型采用不同处理策略
状态管理
记录进度、缓存中间结果；使用全局变量、闭包或外部存储（Redis/文件）保存状态
综合案例："综合新闻汇总" Skill — 抓取多个新闻源、过滤关键词、汇总并输出摘要，包含循环抓取、条件筛选、异常处理和状态记录。
模块五
服务器部署与运维
将 OpenClaw 从个人电脑迁移到服务器，实现长期稳定运行。学习服务器选型、远程部署、后台守护、安全配置和问题排查，为生产环境部署打下坚实基础。
第 16 课：服务器环境准备与远程部署
服务器选型
比较 AWS、Azure、阿里云与自建服务器的优缺点。推荐 Linux（Ubuntu/Debian/CentOS）作为部署平台，稳定且适合长期运行。根据负载选择 CPU、内存、磁盘与带宽配置。
远程连接与权限
SSH 密钥对登录：ssh user@server_ip。强调禁用 root 登录、创建专用用户、设置合理权限。
部署步骤
  1. 安装 Node.js、pnpm/npm、Git、浏览器等依赖
  1. 配置防火墙，开放必要端口（如 18800）
  1. Git clone 或 SFTP 上传代码到服务器
  1. 运行 pnpm install 并初始化
  1. 迁移配置文件，更新路径与 API Key
  1. 启动 Gateway，浏览器验证 Dashboard
第 17 课：24 小时稳定运行与后台服务配置
systemd
Linux 现代 init 系统。创建服务文件，配置开机自启、自动重启、资源限制。使用 systemctl start/stop/status 管理。
pm2
Node.js 生态常用进程管理器。pm2 start 启动，实时监控 CPU/内存，内置日志管理，生成开机自启脚本。
supervisord
语言无关的进程管理工具，配置简单，
适合多种技术栈的服务守护。
日志轮转与监控
使用 logrotate 或 pm2 内置日志管理，按日或按大小切割。使用 top/htop/glances 监控资源，设置告警阈值。
第 18 课：安全配置与问题排查
安全加固要点
  • 密钥安全：API Key 存入环境变量或 .env，限制读取权限，定期轮换
  • 端口安全：防火墙（ufw/firewalld）只开放必要端口
  • 反向代理：Nginx 暴露端口，配置 HTTPS（Let's Encrypt 免费证书）
  • 权限隔离：不以 root 运行服务，文件系统只授权必要目录
  • 容器化：Docker 提供环境隔离和简化部署（进阶）
故障排查方法论
了解发生什么 → 收集信息 → 形成假设 → 验证假设
  • 端口占用：lsof -i :<端口> 定位并释放
  • 模型连接失败：排查网络、API Key、模型服务状态
  • 内存溢出：监控工具定位问题代码或任务
  • 权限错误：检查文件权限和用户身份
模块六
综合实战与落地应用
通过两个实战项目将所有知识串联起来，体验 OpenClaw 在实际工作场景中的应用价值，并在最后一课总结课程内容、规划进阶方向。
第 19 课：实战项目一 —个人办公自动化助手
综合运用文件管理、浏览器操作、定时任务和技能组合，实现自动整理文件、生成报告和定时提醒。项目目录结构：skills/、flows/、configs/，使用 Git 管理版本，撰写安装与故障排查文档。
第 20 课：实战项目二 — 数据采集与分析系统
项目规划
选择采集主题（如商品价格监控、舆情分析、招聘信息汇总），确定指标和来源网站，设计数据结构与字段。
数据采集
浏览器自动化脚本抓取多网站数据，处理动态加载和翻页。控制请求频率，合规操作，保存为 CSV/JSON。
数据清洗与分析
  • 去除重复、处理缺失值、修正异常项
  • 写入 SQLite 或 JSON 文件存档
  • 计算平均价格、趋势变化、热门关键词
  • 使用模型生成自然语言分析报告
  • （可选）生成可视化图表嵌入报告
自动化集成
将采集、清洗、分析配置为定时工作流，定期运行并输出最新报告，对历史数据进行版本控制。
第 21 课：课程总结与进阶方向
回顾全套 21 节课的学习内容，整理知识地图，提炼核心技能，并展望进阶方向。
进阶方向展望
多智能体协同
让多个智能体协同完成复杂任务，了解调度与协作框架，
探索 Agent 间通信机制
RAG 集成
检索增强生成：将知识库与大模型结合，
使用向量数据库提高回答准确度
企业级部署
安全、合规、监控、扩展和运维的企业级考量，
高可用架构与负载均衡
开源社区贡献
贡献新技能、改进文档；学习 Pull Request 流程和代码规范，
参与社区共同推动技术进步
课程知识体系总览
恭喜你完成了 OpenClaw 系统学习训练营！从认识智能体、搭建环境、安装配置，到实现自动化流程、开发技能、部署运维，再到综合项目和未来展望，你已经拥有了一套完整的智能体应用技能。请继续实践、总结和分享，让 OpenClaw 成为你工作和生活中的强大助手。
6
学习模块
21
完整课程
2
综合实战项目
4
进阶方向