🦞 Awesome OpenClaw Tutorial

🦞 一本书玩转OpenClaw：超级个体实战指南

从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南

🔥 2026 年 10 月 · 作者正在更新的新项目

OpenClaw 教程继续保留在下方 👇。这里先列出作者近期正在维护的新仓库，内容方向相近，欢迎顺手看看、点个 Star。

| 预览 | 项目 | 一句话介绍 | Stars | |:---:|---|---|:---:| | <img src="https://raw.githubusercontent.com/xianyu110/awesome-gpt-6-astra/main/sources/martin/website/public/previews/cheerself-001.jpg" width="120" alt="GPT-6 Astra"> | awesome-gpt-6-astra · 在线站 | GPT-6 Astra 社区案例合集：游戏、3D、网页、Computer Use 等可玩 Demo，每条附作者与原帖 | | | <img src="https://raw.githubusercontent.com/xianyu110/awesome-gpt-image2.5/main/assets/og-cover.png" width="120" alt="GPT Image 2.5"> | awesome-gpt-image2.5 · 画廊 | ChatGPT Images 2.5（Flare · Sunburst · Sketch）好玩用法画廊，可直接抄的 prompt 与评测 | | | <img src="https://raw.githubusercontent.com/xianyu110/awesome-minimax-h3-prompts/main/assets/previews/cmsboram6001z04kzkda7f0i4.webp" width="120" alt="MiniMax H3"> | awesome-minimax-h3-prompts · 在线浏览 | MiniMax H3（海螺 3.0）视频提示词精选，每条配生成片段与作者署名 | | | <img src="https://upload.maynor1024.live/file/1776480570690_img_048.png" width="120" alt="GPT Image 2"> | awesome-gptimage2 · 在线站 | GPT Image 2 中文提示词实战手册：电商、海报、产品图等可复制的商业场景 prompt | | | | gpt-codex · 教程站 | 写给小白的 OpenAI Codex 中文教程：从 0 到 1 把 Codex 真正用起来 | | | | awesome-codex-tutorial · 在线版 | Codex 中文教程库：入门教程、系列图文教程、实战案例库与速查资料 | | | | awesome-claudcode-tutorial · 在线阅读 | 最全面的 Claude Code 中文教程，从零基础到企业级应用 | |

🦞 以下为 OpenClaw 中文教程原有内容，持续保留并按版本校对。

---

📖 纸质书《OpenClaw超级个体实操手册》已上市！ 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。🛒 京东专属购买链接（¥42，原价¥59.8）

🔄 2026-09-10 更新说明：本仓库当前按 OpenClaw v2026.9.3（稳定版，2026-09-08 发布） 校对；第 1/2/5/7/8/10~15 章已同步到 2026.9 主线。跨版本请先读 updates/2026-09-10-v2026.9.3.md，升级后执行 openclaw doctor --fix。

📌 本教程与 OpenClaw 最新版差异说明

为了避免你把旧章节当成最新版官方教程，先看这 4 点：

• 当前教程基线：本仓库目前按 v2026.9.3 稳定版校对；如果 GitHub Releases 或 npm 出现更高版本，请以官方 Release Notes 和官方文档为准
• 已优先更新的章节：README、更新说明与第 1/2/5/7/8/10~15 章已按 2026.9 主线修订（含 2026.8 Breaking 迁移提示）
• 仍含历史内容的章节：第 3/4/6/9 章及部分 tutorials/ 一键部署文仍可能含旧截图/旧渠道步骤，适合作为思路参考，不建议直接复制执行
• 当前应优先使用的官方主线：openclaw onboard、openclaw models auth login --provider openai|…、openclaw doctor --fix、openclaw infer ...、openclaw skills …、Task Flow、Webhooks、/usage

| 类型 | 本教程当前状态 | 阅读建议 | |------|----------------|----------| | 版本基线 | 已对齐 v2026.9.3 | 新手优先按这个版本跑通 | | 运行时 | Node 24.16+ 或 26.1+（推荐 26） | 先升 Node 再升 OpenClaw | | 跨版本迁移 | 强调 openclaw doctor --fix | 处理 openai/* 路由、OpenProse 清理、会话 SQLite | | 安装/配置主线 | 已补 2026.9 入口 | 优先看第 2 章和第 11 章 | | 媒体/创意能力 | 保留 infer / 媒体生成 / ComfyUI 主线 | 优先看第 10 章和第 14 章 | | 旧 Skill 生态 | 明确标为历史参考 | 用 openclaw skills，不要默认 clawhub install … |

⚠️ 一句话判断：如果你看到 openai-codex/*、codex/*、/prose、local-anthropic、bananapro-image-gen、整串 clawhub install ...，请先把它理解为“历史参考或需迁移项”，不要默认当成 2026.9 官方推荐步骤。

---

🚀 30秒快速选择：哪种部署方式适合你？

| 你的情况 | 推荐方案 | 为什么 | 开始时间 | |---------|---------|------|---------| | 完全小白，想最快体验 | 飞书妙搭 ⭐ | 免费 + 1分钟完成 + 每日100万Tokens | → 立即开始 | | 有服务器，想可视化管理 | 宝塔面板 | 免费插件 + 面板管理 + 一键安装 | → 3分钟搞定 | | 企业级，需要高安全性 | JVSClaw | 14天免费 + 6核12GB + 端到端加密 | → 需邀请码 | | 想用浏览器操控 | Kimi Claw | Kimi K2.5 + 浏览器控制 | → 200元/月 | | 量化交易/多IM | 腾讯 WorkBuddy | 桌面端Agent + 多IM支持 | → 送5000积分 | | macOS原生体验 | QClaw | 腾讯官方桌面客户端 + 全量公测 | → 免费 | | Agent生态丰富 | 扣子 OpenClaw | 1800+Skills | → 99元/月起 |

📖 查看完整一键部署教程 →

---

📊 教程导航（按学习路径）

🎯 零基础入门（必读）

• 📖 第1章：认识OpenClaw - 5分钟了解核心价值
• 🚀 第2章：快速部署 - 选择适合你的部署方式
• 💬 第3章：快速上手 - 发送第一条消息

🔥 核心功能（实战）

• 📁 第4章：文件管理 - 效率提升81%
• 🧠 第5章：知识库 - 第二大脑系统 + Active Memory / Dreaming 补充
• 📅 第6章：日程管理 - AI自动创建日程
• ⚙️ 第7章：自动化 - 定时任务 + Task Flow / Webhooks 更新

💎 进阶技能（提升）

• 🔌 第8章：Skills扩展 - 1800+技能
• 🤖 第9章：多平台集成 - 飞书/企微/钉钉/QQ/微信
• 🔗 第10章：API 与外部能力集成 - infer / webhooks / 媒体工作流
• ⚙️ 第11章：高级配置 - 模型 / 记忆 / 审批 / 性能

🎯 实战案例（直接套用）

• 👔 第12章：个人效率实战 - 知识工作 / 编程 / 创作 / 学习 / 个人运营
• 🔗 第13章：高级自动化 - cron / tasks / Task Flow / hooks / standing orders
• 🎨 第14章：创意应用 - 图片 / 视频 / 音乐 / TTS / ComfyUI
• 🚀 第15章：一人公司实战 - 选题 / 交付 / 分发 / 复盘

📚 附录工具（速查）

• 命令速查表 | 必装Skills
• 常见问题 | API对比
• 配置模板 | 避坑指南

---

🆘 遇到问题？快速解决

<details> <summary><b>🔧 常见问题速查（点击展开）</b></summary>

安装配置问题

• 安装失败怎么办？
• API连接失败？
• 飞书Bot不回复？

使用问题

• AI变"哑巴"了？ → 切换到 full profile
• Gateway启动失败？ → 检查认证配置

成本优化

• API费用太高？
• 如何省钱？ - 使用国产模型节省95%

</details>

找不到答案？

• 📖 完整FAQ
• 💬 提交问题

---

🚨 重要版本提示

⚠️ 2026.3.7版本：Gateway认证要求（Breaking Change）

Gateway认证现在必须显式设置 gateway.auth.mode（token 或 password）

快速修复：

openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "your-secret-token"
openclaw gateway restart

🔧 2026.3.2版本：AI变"哑巴"了？

症状：只能聊天不能干活（文件管理、命令执行失效） 原因：默认profile改为 messaging（纯聊天模式） 修复：切换到 full profile

openclaw config set tools.profile full
openclaw gateway restart

5种Profile说明：

| Profile | 功能说明 | |---------|---------| | messaging | 只能发布消息、管理会话 | | default | 默认工具集（不含命令执行） | | coding | 编程相关工具 | | full | 完整工具集，包含命令执行（推荐） | | all | 所有工具全开 |

---

🆕 v2026.3.12 重大更新（2026年3月）

建议所有用户升级，包含大量安全修复

新功能

• Control UI 全面重设计：模块化 Dashboard，含概览/聊天/配置/Agent/Session 视图，支持命令面板、移动端底部 Tab、slash 命令、消息导出和消息置顶
• /fast 快速模式开关：支持切换 OpenAI / Anthropic 的 fast tier，更省钱更快
• Kubernetes 支持：新增 K8s 安装路径（支持 Kind 和 raw manifests）
• sessions_yield 工具：Agent 可立即结束当前轮次并携带后续载荷，流程控制更灵活
• Slack Block Kit：Slack 频道消息支持 Block Kit 富文本格式

重要安全修复（建议立即升级）

• 修复跨站 WebSocket 劫持路径
• 修复 workspace plugin 隐式自动加载（防止恶意代码执行）
• 修复 /config、/debug 权限绕过
• 修复共享 token 范围自我提权
• 多处 exec 审批绕过修复

---

🆕 v2026.3.13 更新（2026年3月中旬）

新功能

• Chrome DevTools MCP attach 模式：可直接连接已登录的 Chrome 浏览器进行自动化操作，无需重新登录
• Ollama 一键安装引导：支持 Local 和 Cloud+Local 混合模式，本地模型更好用
• 多模态记忆索引：图片/音频内容可用 Gemini Embedding 进行语义检索
• Docker 时区支持：新增 OPENCLAW_TZ 环境变量
• iOS 首次运行引导页：新用户体验大幅提升

Bug 修复

• 修复工具密集型运行时 Dashboard UI 卡死/重渲染风暴
• 修复 Windows 下 gateway 重启时弹出控制台黑窗口
• 修复 setup code 可被重放攻击的安全漏洞
• 插件 SDK 去重，修复约 2 倍内存膨胀问题

---

🆕 v2026.9.3 稳定版更新（2026年9月8日）

当前基线

• 稳定版：v2026.9.3
• 推荐运行时：Node 26（或 Node 24.16+）；不再支持 Node 22
• 校验方式：npm view openclaw version 应返回 2026.9.3
• 完整跳变说明：updates/2026-09-10-v2026.9.3.md

从 2026.6.8 跳到 2026.9.3，教学上最关键的变化

• OpenClaw 2.0（2026.8.1）：会话/转录迁入 SQLite；Control UI / onboarding 大改；升级前务必备份
• OpenAI 路由迁移：codex/*、openai-codex/* → openai/*（openclaw doctor --fix）
• OpenProse 移除：内置插件与 /prose 下线；清配置用 Doctor，需要时再装上游 Agent Skill
• Skills / Workshop：优先 openclaw skills；Workshop 按 Agent 持久化；clawhub install … 降为历史参考
• 更新恢复（2026.9.x）：更新可预演、失败恢复更干净；关注 openclaw update status
• 仍沿用的 2026.6 主线：Active Memory / Memory Wiki、infer、Task Flow / Webhooks、媒体生成、/usage

升级命令：

# 先确认 Node
node -v   # 需要 24.16+ 或 26.1+

openclaw update --tag 2026.9.