
进阶路线30 天精通探索 Skill 生态 → 接入微信/QQ/Telegram → 开发自定义 Skill90 天落地多 Agent 协同 → 本地模型部署 → 完整项目如文字修仙 Skill→ ClawHub 发布⚡ 关键要点国内部署必须用镜像pip 清华源 npm 淘宝镜像 git Gitee否则大概率超时云服务器地域选香港国内地域联网搜索受限且需备案所有自定义内容放 ~/.openclaw/workspace/不要放源码目录更新不会覆盖改完配置必须重启 Gatewayopenclaw gateway restart这是最高频忘记的一步新手模型首选百炼 qwen3-max免费额度 国内访问快 中文效果好目标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安装必装 Skill1 小时4 个新手必装 SkillSkill 安装常见问题Day 53 个实战场景2 小时场景 1办公自动化 — 批量整理文件场景 2学习辅助 — 检索资料 生成笔记场景 3系统监控 — 服务器状态 异常提醒Day 6进阶自动化1 小时定时任务以每天 9 点生成资讯摘要为例开机自启Day 7排错自查 制定进阶计划90% 的问题都能自查解决 30 天精通路线图Day 8-30第 2 周探索 Skill 生态第 3 周接入消息渠道第 4 周开发你的第一个自定义 SkillSkill 目录结构SKILL.md 完整模板加载和测试发布到 ClawHub 90 天精通路线图Day 31-90第 2 个月深度定制 多 Agent 协同第 3 个月项目落地 社区贡献 学习资源清单官方资源必看中文教程推荐英文教程避坑指南⚡ 速查命令手册 第一件事搞清楚 OpenClaw 到底是什么一句话OpenClaw 不是聊天机器人是「能动手做事的 AI 代理」。对比传统对话 AIChatGPT/ClaudeOpenClaw核心能力生成内容、分析问题生成内容 操作系统 执行任务交互范围仅聊天窗口本地文件、终端、浏览器、第三方工具数据存储云端托管本地优先数据完全自主扩展方式内置功能固定Skill 插件无限扩展1800 可用运行方式打开网页就用需要部署 Gateway 服务三大核心组件┌──────────────────────────────────────────┐ │ Gateway网关— 中枢神经 │ │ 接收指令 → 调度 Skill → 对接大模型 │ │ 默认监听 localhost:18789 │ ├──────────────────────────────────────────┤ │ Skill技能— 功能插件 │ │ 每个对应一项具体任务 │ │ 通过 ClawHub 一键安装1800 │ ├──────────────────────────────────────────┤ │ Model模型— AI 大脑 │ │ 支持本地模型 云端模型 │ │ 新手优先用云端模型免 GPU │ └──────────────────────────────────────────┘️ 7 天入门路线图天数目标产出D1建立核心认知理解 Gateway/Skill/Model 三层架构D2完成部署本地或云服务器跑通 OpenClawD3配置 AI 模型接入百炼/DeepSeek/OpenAI验证可用D4安装必装 Skill4 个基础 Skill 安装并测试D5完成实战场景3 个高频场景跑通D6进阶自动化定时任务 开机自启D7排错 规划常见问题自查 制定进阶计划Day 1建立核心认知30 分钟必读资源资源地址说明官方文档中文openclawcn.com最权威跟随最新版29 万字中文教程github.com/yugui-ma/openclaw-learn17 章 4 附录最全面阿里云新手路径阿里云开发者社区搜索「OpenClaw 新手学习路径」含百炼 API 配置FreeCodeCamp 教程freecodecamp.org/news/openclaw-full-tutorial-for-beginners英文交互式关键概念速记GatewayOpenClaw 的核心服务进程所有消息经过它调度Skill一个包含SKILL.md的目录告诉 AI 在特定场景下怎么做Channel消息入口微信/QQ/Telegram/Discord/WhatsAppAgent一个完整的 AI 人格含记忆、Skill、配置ClawHubSkill 应用商店clawhub install xxx一键安装workspace~/.openclaw/workspace/— 你的所有自定义内容都在这Day 2完成部署2 小时方案选择方案适合谁优势劣势本地部署隐私优先、临时使用零成本、数据不出门关机就断云服务器部署7×24 运行、定时任务随时访问、持续运行需付费~30 元/月起macOS 应用Mac 用户最简单菜单栏一键启动仅 Mac本地部署Windows保姆级# 1. 安装基础环境管理员 PowerShellwinget 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-urlhttps://pypi.tuna.tsinghua.edu.cn/simple npm install--registryhttps://registry.npmmirror.com# 6. 初始化配置npm run onboard# 7. 启动服务start/b npm runstart%USERPROFILE%\.openclaw\logs\local-start.log 21# 8. 生成访问 Tokenopenclaw token generate访问http://localhost:18789/?token你的Token看到 Web 控制台即成功。本地部署Mac/Linux# Macbrewinstallgitnode22 python3.9# Ubuntu/Debiansudoaptupdatesudoaptinstallgitnodejs22.* python3.9 python3-pip-y# 克隆 安装gitclone https://gitee.com/openclaw/openclaw.gitcdopenclaw python3-mvenv venvsourcevenv/bin/activate pip3install-rrequirements.txt --index-urlhttps://pypi.tuna.tsinghua.edu.cn/simplenpminstall--registryhttps://registry.npmmirror.comnpmrun onboard# 启动nohupnpmrun start~/.openclaw/logs/local-start.log21openclaw token generate云服务器部署阿里云 5 分钟一键版阿里云轻量应用服务器镜像选OpenClaw 稳定版最低配置2vCPU 4GiB 内存 40GiB ESSD地域选中国香港国内地域联网搜索受限免备案安全组放行18789OpenClaw22SSH端口进入应用详情 → 一键配置 → 输入百炼 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推荐 4GiBDay 3配置 AI 模型1 小时推荐模型配置方案模型提供商成本推荐场景qwen3-max阿里百炼新用户有免费额度⭐ 新手首选deepseek-v3DeepSeek极低成本性价比最高gpt-4o-miniOpenAI中等效果稳定llama3.1:70b本地 Ollama免费有 GPU 的进阶用户百炼 API 配置新手首选# 1. 登录 dashscope.console.aliyun.com 创建 API-Key# 2. 配置到 OpenClawopenclaw configsetmodels.providers.bailian.accessKeyId你的Keyopenclaw configsetmodels.providers.bailian.accessKeySecret你的Secretopenclaw configsetmodels.providers.bailian.baseUrlhttps://dashscope.aliyuncs.com/compatible-mode/v1openclaw configsetmodels.defaultqwen3-maxopenclaw configsetmodels.providers.bailian.timeout60000# 3. 重启生效openclaw gateway restart--local# 本地# systemctl restart openclaw # 阿里云# 4. 验证openclaw agent--message你好请用一句话介绍你自己也可用 Web 控制台配置访问http://localhost:18789左侧菜单 → Config → ModelsProvider 选 alibaba-cloud → 填 Key → Test Connection成功后重启服务API 配置 6 大坑坑症状解法Key 复制多了空格invalid api key逐字符核对接口地址选错connection failed国内用dashscope.aliyuncs.com海外用dashscope-intl额度耗尽quota exhausted百炼控制台领免费额度忘记重启配置不生效改完必须openclaw gateway restartKey 泄露高额费用用子账号创建最小权限网络不通超时服务器选香港/海外地域Day 4安装必装 Skill1 小时4 个新手必装 Skill# 1. 技能搜索导航 — 找更多 Skill 用clawhubinstallfind-skills# 2. 联网搜索 — 打破模型知识截止日限制clawhubinstalltavily-search# 3. 本地文件管理 — 整理文件、读写分类clawhubinstallfile-manager# 4. 系统命令执行 — 执行终端命令clawhubinstallshell-skills# 验证全部就绪openclaw skills list--statusreadySkill 安装常见问题# 网络不好用国内镜像clawhubinstalltavily-search--registryhttps://gitee.com/clawhub# 找不到 Skill先搜索确认名称openclaw skills search 关键词# 安装后不生效重启 Gatewayopenclaw gateway restartDay 53 个实战场景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 点生成资讯摘要为例openclawcronadd\--namedaily-industry-news\--schedule0 9 * * *\--skilltavily-search\--params{query:2026年AI行业最新资讯, summary_length: 200字}openclawcronstart openclawcronlist开机自启系统方法阿里云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关终端服务就断用nohupMac/Linux或start /bWindows后台启动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 Pluginopenclaw channels login wechat# QQ通过 Gensokyo/OneBot 桥接# 参考github.com/Hoshinonyaruko/Gensokyo# Telegram官方支持openclaw channels login telegram# Discord官方支持openclaw channels login discord# 查看已连接渠道openclaw channels list第 4 周开发你的第一个自定义 SkillSkill 目录结构~/.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发布到 ClawHubclawhub publish my-first-skill 90 天精通路线图Day 31-90第 2 个月深度定制 多 Agent 协同周次主题产出W5-W6多 Agent 配置主 Agent 专项 Agent开发/运维/写作W7本地模型部署Ollama Llama3.1实现「零 API 成本」运行W8Hook 机制事件驱动的自动化文件变更触发、消息触发第 3 个月项目落地 社区贡献周次主题产出W9-W10完整项目开发如文字修仙 Skill / AI 动画制作 SkillW11Skill 发布 文档ClawHub 发布 README 使用教程W12社区贡献提交 PR / 回答 Issue / 写教程博客 学习资源清单官方资源必看资源地址优先级官方文档中文openclawcn.com⭐⭐⭐官方文档英文docs.openclaw.ai⭐⭐⭐GitHub 仓库github.com/openclaw/openclaw⭐⭐⭐ClawHub Skill 商店clawhub.com⭐⭐中文教程推荐资源说明优先级openclaw-learn29 万字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 管理 clawhubinstallskill-name# 安装 Skillclawhub publishskill-name# 发布 Skillopenclaw skills list# 查看已安装openclaw skills search关键词# 搜索 Skillopenclaw skillsenablename# 激活 Skill# 模型配置 openclaw configsetmodels.defaultqwen3-max# 设置默认模型openclaw configsetmodels.providers.bailian.xxx值# 百炼配置# 渠道管理 openclaw channels loginchannel# 登录渠道openclaw channels list# 查看已连接# 测试 openclaw agent--message你的指令# 命令行测试# 定时任务 openclawcronadd--namexxx--schedule0 9 * * *--skillxxxopenclawcronstart openclawcronlist