进阶路线
目标：7 天入门 → 30 天精通 → 90 天能开发 Skill 并落地项目
文章目录 📌 第一件事：搞清楚 OpenClaw 到底是什么 🗓️ 7 天入门路线图 Day 1：建立核心认知（30 分钟） Day 2：完成部署（2 小时） 方案选择 本地部署（Windows，保姆级） 本地部署（Mac/Linux） 云服务器部署（阿里云 5 分钟一键版） 部署必踩 4 个坑 Day 3：配置 AI 模型（1 小时） 推荐模型配置方案 百炼 API 配置（新手首选） 也可用 Web 控制台配置 API 配置 6 大坑 Day 4：安装必装 Skill（1 小时） 4 个新手必装 Skill Skill 安装常见问题 Day 5：3 个实战场景（2 小时） 场景 1：办公自动化 — 批量整理文件 场景 2：学习辅助 — 检索资料 + 生成笔记 场景 3：系统监控 — 服务器状态 + 异常提醒 Day 6：进阶自动化（1 小时） 定时任务（以每天 9 点生成资讯摘要为例） 开机自启 Day 7：排错自查 + 制定进阶计划 🚀 30 天精通路线图（Day 8-30） 第 2 周：探索 Skill 生态 第 3 周：接入消息渠道 第 4 周：开发你的第一个自定义 Skill Skill 目录结构 SKILL.md 完整模板 加载和测试 发布到 ClawHub 🏆 90 天精通路线图（Day 31-90） 第 2 个月：深度定制 + 多 Agent 协同 第 3 个月：项目落地 + 社区贡献 📚 学习资源清单 ⚡ 速查命令手册 📌 第一件事：搞清楚 OpenClaw 到底是什么 一句话 ：OpenClaw 不是聊天机器人，是「能动手做事的 AI 代理」。
对比 传统对话 AI（ChatGPT/Claude） OpenClaw 核心能力 生成内容、分析问题 生成内容 + 操作系统 + 执行任务 交互范围 仅聊天窗口 本地文件、终端、浏览器、第三方工具 数据存储 云端托管 本地优先，数据完全自主 扩展方式 内置功能固定 Skill 插件无限扩展（1800+ 可用） 运行方式 打开网页就用 需要部署 Gateway 服务
三大核心组件：
┌──────────────────────────────────────────┐ │ Gateway（网关）— 中枢神经 │ │ 接收指令 → 调度 Skill → 对接大模型 │ │ 默认监听 localhost:18789 │ ├──────────────────────────────────────────┤ │ Skill（技能）— 功能插件 │ │ 每个对应一项具体任务 │ │ 通过 ClawHub 一键安装（1800+） │ ├──────────────────────────────────────────┤ │ Model（模型）— AI 大脑 │ │ 支持本地模型 + 云端模型 │ │ 新手优先用云端模型（免 GPU） │ └──────────────────────────────────────────┘🗓️ 7 天入门路线图 天数 目标 产出 D1 建立核心认知 理解 Gateway/Skill/Model 三层架构 D2 完成部署 本地或云服务器跑通 OpenClaw D3 配置 AI 模型 接入百炼/DeepSeek/OpenAI，验证可用 D4 安装必装 Skill 4 个基础 Skill 安装并测试 D5 完成实战场景 3 个高频场景跑通 D6 进阶自动化 定时任务 + 开机自启 D7 排错 + 规划 常见问题自查 + 制定进阶计划
Day 1：建立核心认知（30 分钟） 必读资源 资源 地址 说明 官方文档（中文） openclawcn.com 最权威，跟随最新版 29 万字中文教程 github.com/yugui-ma/openclaw-learn 17 章 + 4 附录，最全面 阿里云新手路径 阿里云开发者社区搜索「OpenClaw 新手学习路径」 含百炼 API 配置 FreeCodeCamp 教程 freecodecamp.org/news/openclaw-full-tutorial-for-beginners 英文，交互式
关键概念速记 Gateway ：OpenClaw 的核心服务进程，所有消息经过它调度Skill ：一个包含SKILL.md的目录，告诉 AI 在特定场景下怎么做Channel ：消息入口（微信/QQ/Telegram/Discord/WhatsApp）Agent ：一个完整的 AI 人格（含记忆、Skill、配置）ClawHub ：Skill 应用商店，clawhub install xxx一键安装workspace ：~/.openclaw/workspace/— 你的所有自定义内容都在这Day 2：完成部署（2 小时） 方案选择 方案 适合谁 优势 劣势 本地部署 隐私优先、临时使用 零成本、数据不出门 关机就断 云服务器部署 7×24 运行、定时任务 随时访问、持续运行 需付费（~30 元/月起） macOS 应用 Mac 用户 最简单，菜单栏一键启动 仅 Mac
本地部署（Windows，保姆级） # 1. 安装基础环境（管理员 PowerShell） winget install Git. Git- y winget install OpenJS. NodeJS. LTS-- version 22. 1. 0- y winget install Python. Python. 3. 9- y# 2. 验证环境 git-- version && node-- version && python-- version# 3. 克隆仓库（国内镜像加速） git clone https:/ / gitee. com/openclaw/openclaw. git cd openclaw# 4. 创建 Python 虚拟环境 python- m venv venv. \venv\Scripts\Activate. ps1# 5. 安装依赖（国内镜像） pip install- r requirements. txt-- index-url=https:/ / pypi. tuna. tsinghua. edu. cn/simple npm install-- registry=https:/ / registry. npmmirror. com# 6. 初始化配置 npm run onboard# 7. 启动服务 start / b npm runstart >% USERPROFILE%\. openclaw\logs\local-start . log 2>&1# 8. 生成访问 Token openclaw token generate访问http://localhost:18789/?token=你的Token，看到 Web 控制台即成功。
本地部署（Mac/Linux） # Mac brewinstall git node@22 python@3.9# Ubuntu/Debian sudo apt update&& sudo apt install git nodejs = 22 .* python3.9 python3-pip-y # 克隆 + 安装 git clone https://gitee.com/openclaw/openclaw.gitcd openclaw python3-m venv venv&& source venv/bin/activate pip3install -r requirements.txt --index-url= https://pypi.tuna.tsinghua.edu.cn/simplenpm install --registry = https://registry.npmmirror.comnpm run onboard# 启动 nohup npm run start> ~/.openclaw/logs/local-start.log2 >&1 & openclaw token generate云服务器部署（阿里云 5 分钟一键版） 阿里云轻量应用服务器，镜像选OpenClaw 稳定版 最低配置：2vCPU + 4GiB 内存 + 40GiB ESSD 地域选中国香港 （国内地域联网搜索受限，免备案）安全组放行18789（OpenClaw）+22（SSH）端口 进入应用详情 → 一键配置 → 输入百炼 API-Key → 生成 Token 访问http://公网IP:18789/?token=你的Token 部署必踩 4 个坑 坑 症状 解法 端口 18789 被占 启动失败 Windows: `netstat -ano 虚拟环境失效 pip 找不到包 重新source venv/bin/activate或.\venv\Scripts\Activate.ps1 依赖安装超时 npm/pip 报错 必须用国内镜像（清华源 + 淘宝镜像） 云服务器内存不足 服务崩溃 最低 1.5GiB，推荐 4GiB
Day 3：配置 AI 模型（1 小时） 推荐模型配置方案 模型 提供商 成本 推荐场景 qwen3-max 阿里百炼 新用户有免费额度 ⭐ 新手首选 deepseek-v3 DeepSeek 极低成本 性价比最高 gpt-4o-mini OpenAI 中等 效果稳定 llama3.1:70b 本地 Ollama 免费 有 GPU 的进阶用户
百炼 API 配置（新手首选） # 1. 登录 dashscope.console.aliyun.com 创建 API-Key # 2. 配置到 OpenClaw openclaw configset models.providers.bailian.accessKeyId"你的Key" openclaw configset models.providers.bailian.accessKeySecret"你的Secret" openclaw configset models.providers.bailian.baseUrl"https://dashscope.aliyuncs.com/compatible-mode/v1" openclaw configset models.default"qwen3-max" openclaw configset models.providers.bailian.timeout60000 # 3. 重启生效 openclaw gateway restart--local # 本地 # systemctl restart openclaw # 阿里云 # 4. 验证 openclaw agent--message "你好，请用一句话介绍你自己" 也可用 Web 控制台配置 访问http://localhost:18789 左侧菜单 → Config → Models Provider 选 alibaba-cloud → 填 Key → Test Connection 成功后重启服务 API 配置 6 大坑 坑 症状 解法 Key 复制多了空格 invalid api key 逐字符核对 接口地址选错 connection failed 国内用dashscope.aliyuncs.com，海外用dashscope-intl 额度耗尽 quota exhausted 百炼控制台领免费额度 忘记重启 配置不生效 改完必须openclaw gateway restart Key 泄露 高额费用 用子账号创建，最小权限 网络不通 超时 服务器选香港/海外地域
Day 4：安装必装 Skill（1 小时） 4 个新手必装 Skill # 1. 技能搜索导航 — 找更多 Skill 用 clawhubinstall find-skills# 2. 联网搜索 — 打破模型知识截止日限制 clawhubinstall tavily-search# 3. 本地文件管理 — 整理文件、读写分类 clawhubinstall file-manager# 4. 系统命令执行 — 执行终端命令 clawhubinstall shell-skills# 验证全部就绪 openclaw skills list--status readySkill 安装常见问题 # 网络不好？用国内镜像 clawhubinstall tavily-search--registry = https://gitee.com/clawhub# 找不到 Skill？先搜索确认名称 openclaw skills search 关键词# 安装后不生效？重启 Gateway openclaw gateway restartDay 5：3 个实战场景（2 小时） 场景 1：办公自动化 — 批量整理文件 直接在 Web 控制台输入：
用 file-manager 技能，整理我的下载文件夹（路径：C:\Users\你的用户名\Downloads），按文档（pdf、doc、txt）、图片（jpg、png）、视频（mp4）分类，创建对应文件夹存放；用 tavily-search 技能搜索「文件分类最佳实践」，结合整理结果生成一份 100 字的文件管理总结。
场景 2：学习辅助 — 检索资料 + 生成笔记 用 tavily-search 技能，检索 2026 年 AI 行业核心发展趋势，筛选 3 个权威来源；基于检索结果，生成一份结构化学习笔记，包含核心趋势、代表技术、应用场景，分点列出。
场景 3：系统监控 — 服务器状态 + 异常提醒 用 shell-skills 技能，执行top -b -n 1 | head -n 5命令获取 CPU 与内存占用率；若 CPU 超过 80% 或内存超过 85%，生成提醒消息，包含当前占用率与建议操作。
Day 6：进阶自动化（1 小时） 定时任务（以每天 9 点生成资讯摘要为例） openclawcron add \ --name "daily-industry-news" \ --schedule "0 9 * * *" \ --skill "tavily-search" \ --params '{"query":"2026年AI行业最新资讯", "summary_length": "200字"}' openclawcron start openclawcron list开机自启 系统 方法 阿里云 systemctl enable openclaw（已自动配置）Windows 创建.bat脚本 → 添加到任务计划程序 Mac 创建启动脚本 → 添加到登录项 Linux 创建 systemd 服务
Day 7：排错自查 + 制定进阶计划 90% 的问题都能自查解决 问题 排查步骤 Skill 安装失败 ①换国内镜像 ②openclaw skills search确认名称 ③检查依赖 指令执行无响应 ①openclaw gateway status②验证 API 配置 ③openclaw skills enable 技能名 Web 控制台打不开 ①检查 18789 端口 ②重启服务 ③重新生成 Token 关终端服务就断 用nohup（Mac/Linux）或start /b（Windows）后台启动 API 超时 ①延长 timeout ②换更快的模型 ③检查网络
🚀 30 天精通路线图（Day 8-30） 第 2 周：探索 Skill 生态 目标：安装 5+ 行业专属 Skill，建立个人工具箱 推荐方向： ├── 开发者：github-skill、code-review、docker-manager ├── 内容创作者：blog-writer、image-gen、video-gen ├── 数据分析：data-analyzer、chart-gen、report-writer └── 生活助手：weather、recipe、fitness-tracker第 3 周：接入消息渠道 # 微信（通过 WeChat Channel Plugin） openclaw channels login wechat# QQ（通过 Gensokyo/OneBot 桥接） # 参考：github.com/Hoshinonyaruko/Gensokyo # Telegram（官方支持） openclaw channels login telegram# Discord（官方支持） openclaw channels login discord# 查看已连接渠道 openclaw channels list第 4 周：开发你的第一个自定义 Skill Skill 目录结构 ~/.openclaw/workspace/skills/my-first-skill/ ├── SKILL.md # 必须：定义技能指令和工具 ├── script.py # 可选：Python 脚本 ├── script.sh # 可选：Shell 脚本 └── resources/ # 可选：静态资源SKILL.md 完整模板 --- name: my-first-skill description: 一个简单的自定义技能示例 metadata: openclaw: os: ["darwin", "linux", "win32"] requires: bins: ["python3"] config: ["models.default"] --- # My First Skill ## 什么时候使用 当用户要求执行 [具体任务描述] 时，使用此技能。 ## 执行步骤 1. 使用 `exec` 工具执行脚本 `script.py` 2. 将结果格式化返回给用户 ## 工具定义 ### my_tool 描述：执行 XXX 操作 参数： - input (string, 必需)：输入内容 - format (string, 可选)：输出格式，默认 "json" ## 注意事项 - 确保输入参数合法 - 异常时返回错误信息加载和测试 # 加载 openclaw gateway restart# 验证 openclaw skills list# 测试 openclaw agent--message "使用 my-first-skill 执行 XXX" 发布到 ClawHub clawhub publish my-first-skill🏆 90 天精通路线图（Day 31-90） 第 2 个月：深度定制 + 多 Agent 协同 周次 主题 产出 W5-W6 多 Agent 配置 主 Agent + 专项 Agent（开发/运维/写作） W7 本地模型部署 Ollama + Llama3.1，实现「零 API 成本」运行 W8 Hook 机制 事件驱动的自动化：文件变更触发、消息触发
第 3 个月：项目落地 + 社区贡献 周次 主题 产出 W9-W10 完整项目开发 如：文字修仙 Skill / AI 动画制作 Skill W11 Skill 发布 + 文档 ClawHub 发布 + README + 使用教程 W12 社区贡献 提交 PR / 回答 Issue / 写教程博客
📚 学习资源清单 官方资源（必看） 资源 地址 优先级 官方文档（中文） openclawcn.com ⭐⭐⭐ 官方文档（英文） docs.openclaw.ai ⭐⭐⭐ GitHub 仓库 github.com/openclaw/openclaw ⭐⭐⭐ ClawHub Skill 商店 clawhub.com ⭐⭐
中文教程（推荐） 资源 说明 优先级 openclaw-learn（29 万字） github.com/yugui-ma/openclaw-learn ⭐⭐⭐ 阿里云新手路径 搜索「OpenClaw 新手学习路径」 ⭐⭐⭐ 阿里云进阶攻略 搜索「OpenClaw 进阶多场景实战指南」 ⭐⭐ OpenClaw 中文站 openclawchina.com ⭐⭐
英文教程 资源 说明 优先级 FreeCodeCamp 完整教程 freecodecamp.org/news/openclaw-full-tutorial ⭐⭐ StartClaw 初学者指南 startclaw.com/blog/openclaw-setup-guide ⭐⭐
避坑指南 坑 解法 不要把自定义内容放进 openclaw 源码目录 放~/.openclaw/workspace/，更新不会覆盖 不要同时跑多个 Gateway 端口冲突，只保留一个 不要用 root 跑 OpenClaw 安全风险，用普通用户 不要忽略npm run onboard 这是初始化配置的关键步骤 国内网络用镜像 pip 清华源 + npm 淘宝镜像 + git Gitee
⚡ 速查命令手册 # === 服务管理 === openclaw gateway start# 启动网关 openclaw gateway restart# 重启网关 openclaw gateway status# 查看状态 openclaw token generate# 生成访问 Token # === Skill 管理 === clawhubinstall < skill-name> # 安装 Skill clawhub publish< skill-name> # 发布 Skill openclaw skills list# 查看已安装 openclaw skills search< 关键词> # 搜索 Skill openclaw skillsenable < name> # 激活 Skill # === 模型配置 === openclaw configset models.default"qwen3-max" # 设置默认模型 openclaw configset models.providers.bailian.xxx"值" # 百炼配置 # === 渠道管理 === openclaw channels login< channel> # 登录渠道 openclaw channels list# 查看已连接 # === 测试 === openclaw agent--message "你的指令" # 命令行测试 # === 定时任务 === openclawcron add --name "xxx" --schedule "0 9 * * *" --skill "xxx" openclawcron start openclawcron list
