进阶路线
30 天精通：探索 Skill 生态 → 接入微信/QQ/Telegram → 开发自定义 Skill
90 天落地：多 Agent 协同 → 本地模型部署 → 完整项目（如文字修仙 Skill）→ ClawHub 发布
⚡ 关键要点
国内部署必须用镜像：pip 清华源 + npm 淘宝镜像 + git Gitee，否则大概率超时
云服务器地域选香港：国内地域联网搜索受限，且需备案
所有自定义内容放 ~/.openclaw/workspace/：不要放源码目录，更新不会覆盖
改完配置必须重启 Gateway：openclaw gateway restart，这是最高频忘记的一步
新手模型首选百炼 qwen3-max：免费额度 + 国内访问快 + 中文效果好

目标：7 天入门 → 30 天精通 → 90 天能开发 Skill 并落地项目
原则：每一步都可执行、可验证、不跳步

---

📌 第一件事：搞清楚 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 run start > %USERPROFILE%\.openclaw\logs\local-start.log 2>&1

# 8. 生成访问 Token
openclaw token generate

访问 http://localhost:18789/?token=你的Token，看到 Web 控制台即成功。

本地部署（Mac/Linux）

# Mac
brew install 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.git
cd openclaw
python3 -m venv venv && source venv/bin/activate
pip3 install -r requirements.txt --index-url=https://pypi.tuna.tsinghua.edu.cn/simple
npm install --registry=https://registry.npmmirror.com
npm run onboard

# 启动
nohup npm run start > ~/.openclaw/logs/local-start.log 2>&1 &
openclaw token generate

云服务器部署（阿里云 5 分钟一键版）

1. 阿里云轻量应用服务器，镜像选 OpenClaw 稳定版
2. 最低配置：2vCPU + 4GiB 内存 + 40GiB ESSD
3. 地域选中国香港（国内地域联网搜索受限，免备案）
4. 安全组放行 18789（OpenClaw）+ 22（SSH）端口
5. 进入应用详情 → 一键配置 → 输入百炼 API-Key → 生成 Token
6. 访问 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 config set models.providers.bailian.accessKeyId "你的Key"
openclaw config set models.providers.bailian.accessKeySecret "你的Secret"
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
openclaw config set models.default "qwen3-max"
openclaw config set models.providers.bailian.timeout 60000

# 3. 重启生效
openclaw gateway restart --local    # 本地
# systemctl restart openclaw        # 阿里云

# 4. 验证
openclaw agent --message "你好，请用一句话介绍你自己"

也可用 Web 控制台配置

1. 访问 http://localhost:18789
2. 左侧菜单 → Config → Models
3. Provider 选 alibaba-cloud → 填 Key → Test Connection
4. 成功后重启服务

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 用
clawhub install find-skills

# 2. 联网搜索 — 打破模型知识截止日限制
clawhub install tavily-search

# 3. 本地文件管理 — 整理文件、读写分类
clawhub install file-manager

# 4. 系统命令执行 — 执行终端命令
clawhub install shell-skills

# 验证全部就绪
openclaw skills list --status ready

Skill 安装常见问题

# 网络不好？用国内镜像
clawhub install tavily-search --registry=https://gitee.com/clawhub

# 找不到 Skill？先搜索确认名称
openclaw skills search 关键词

# 安装后不生效？重启 Gateway
openclaw gateway restart

---

Day 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 点生成资讯摘要为例）

openclaw cron add \
  --name "daily-industry-news" \
  --schedule "0 9 * * *" \
  --skill "tavily-search" \
  --params '{"query":"2026年AI行业最新资讯", "summary_length": "200字"}'

openclaw cron start
openclaw cron 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 管理 ===
clawhub install <skill-name>    # 安装 Skill
clawhub publish <skill-name>    # 发布 Skill
openclaw skills list            # 查看已安装
openclaw skills search <关键词>  # 搜索 Skill
openclaw skills enable <name>   # 激活 Skill

# === 模型配置 ===
openclaw config set models.default "qwen3-max"        # 设置默认模型
openclaw config set models.providers.bailian.xxx "值"  # 百炼配置

# === 渠道管理 ===
openclaw channels login <channel>  # 登录渠道
openclaw channels list             # 查看已连接

# === 测试 ===
openclaw agent --message "你的指令"  # 命令行测试

# === 定时任务 ===
openclaw cron add --name "xxx" --schedule "0 9 * * *" --skill "xxx"
openclaw cron start
openclaw cron list

---