🦞 Awesome OpenClaw Tutorial

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

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

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

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

预览	项目	一句话介绍	Stars
	awesome-gpt-6-astra · 在线站	GPT-6 Astra 社区案例合集：游戏、3D、网页、Computer Use 等可玩 Demo，每条附作者与原帖
	awesome-gpt-image2.5 · 画廊	ChatGPT Images 2.5（Flare · Sunburst · Sketch）好玩用法画廊，可直接抄的 prompt 与评测
	awesome-minimax-h3-prompts · 在线浏览	MiniMax H3（海螺 3.0）视频提示词精选，每条配生成片段与作者署名
	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

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

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

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

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

🎯 零基础入门（必读）

• 📖 第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对比
• 配置模板 | 避坑指南

🆘 遇到问题？快速解决

找不到答案？

• 📖 完整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说明：

🆕 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.3 --yes
openclaw update repair
openclaw doctor --fix
openclaw --version  # 确认版本为 2026.9.3

⚠️ 新手建议：目标是“按教程稳定跑通”就用 v2026.9.3。若 openclaw update 失败，可用 npm install -g [email protected] --allow-scripts=openclaw 兜底。升级后先跑 openclaw doctor --fix、openclaw models status --probe 和 openclaw channels status。

📎 历史基线：v2026.6.8（2026年6月16日）

以下内容保留为历史对照，不再作为当前推荐基线。

• 当时推荐运行时多为 Node 24 / 兼容 Node 22.19+
• 确立了 Active Memory、Dreaming、Memory Wiki、Task Flow、Webhooks、openclaw infer、内建媒体与 /usage footer 等主线
• 若你的笔记/脚本仍写着 openai-codex/* 或整串 clawhub install …，请按上文迁移到 2026.9 主线

📖 纸质书：《OpenClaw超级个体实操手册》

⚠️ 当前说明：开源教程的第 1/2/5/7/8/10~15 章已按 v2026.9.3 主线修订；纸质书仍然是更系统的重写版，适合需要完整、稳定、逐条验证内容的读者。

纸质书已全面修正，现已上市！

清华大学出版社出版《OpenClaw超级个体实操手册》，在开源教程基础上做了全面重写+逐条验证：

• 🔍 144条CLI命令对照官方文档逐条核对（教程中约60%已删除或修正）
• ✅ 9套配置模板全部在v2026.3.7+实际跑通
• 🛡️ 新增安全防护指南 + 国产Claw全景指南
• 📦 7份随书附赠电子资料

🛒 购买链接：京东专属链接（¥42，原价¥59.8）

📦 本地一键部署安装包：https://tryopenclaw.asia/

📖 关于本教程

🎯 教程特色

1. 超级个体定位 - 一个人+OpenClaw=无限可能，效率提升10倍
2. 云端部署优先 - 降低技术门槛，手机随时使用
3. 国产模型为主 - 成本低、速度快、中文友好
4. 实战案例丰富 - 70+完整工作流，可直接应用
5. 中国本土化 - 企业微信/钉钉/飞书深度集成
6. 完整资源导航 - 官方资源、社区资源、学习路径

📊 教程规模

• ✅ 15章节正文：约267,000字
• ✅ 15个附录：约141,000字
• ✅ 总字数：408,000字
• ✅ 70+实战案例：可直接应用
• ✅ 完整配图：50+张配置截图

🎯 适合人群

• 🚀 超级个体：想要一个人顶一个团队，实现个人价值最大化
• 🔰 完全新手：从零开始，手把手教你安装配置
• 💼 知识工作者：学习如何用OpenClaw提升10倍个人效率
• 👨‍💻 开发者：深入了解Skills开发和API集成
• ✍️ 内容创作者：探索自动化工作流和高级应用

📚 完整教程目录

第一部分：零基础入门（3章节）

• 第1章：OpenClaw是什么？
• 第2章：5分钟完成部署
• 第3章：发送第一条消息

第二部分：核心功能（4章节）

• 第4章：本地文件管理
• 第5章：个人知识库
• 第6章：日程管理
• 第7章：自动化工作流

第三部分：进阶技能（4章节）

• 第8章：Skills扩展
• 第9章：多平台集成
• 第10章：API 与外部能力集成
• 第11章：高级配置（模型、记忆、审批与性能）

第四部分：实战案例（4章节）

• 第12章：个人效率实战
• 第13章：高级自动化工作流
• 第14章：创意应用实战
• 第15章：一人公司实战

🔗 官方资源

• OpenClaw官方网站：https://openclaw.ai
• OpenClaw官方文档：https://docs.openclaw.ai
• GitHub仓库：https://github.com/openclaw/openclaw
• ClawHub技能广场：https://clawhub.ai
• Awesome Skills合集：https://github.com/VoltAgent/awesome-openclaw-skills

💡 实战案例精选

📦 配置示例（开箱即用）

• 基础配置
• 多模型配置
• 多Agent配置
• 飞书Bot配置

🎬 实战场景

• 文件管理：找发票
• 知识管理：网页存档
• 日程管理：截图识别
• 自动化：网站监控

📊 成本对比

💡 省钱技巧：使用国产大模型（DeepSeek、Kimi）节省**50%-70%**成本

🤝 贡献指南

欢迎贡献你的经验和案例！

1. Fork本仓库
2. 创建你的分支 (git checkout -b feature/AmazingFeature)
3. 提交你的修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交Pull Request

📮 联系方式

社交媒体

• GitHub: @xianyu110
• CSDN专栏: OpenClaw从入门到精通
• B站: @MaynorAI
• YouTube: @buguniao537
• X (Twitter): @Nikitka_aktikiN

项目链接

• Clawbot项目: 700+ Stars
• 两万人AI社区主理人

📈 项目进度

• ✅ v1.12（2026-09-10）：同步 OpenClaw v2026.9.3，覆盖 README / 安装升级 / 模型路由迁移 / Doctor / 关键章节基线，并新增 updates/2026-09-10-v2026.9.3.md
• ✅ v1.11（2026-06-18）：同步 OpenClaw v2026.6.8 稳定版，更新安装升级命令、版本基线、模型/渠道/usage/search 说明
• ✅ v1.10（2026-04-16）：第 10~15 章按 OpenClaw v2026.4.14 稳定版主线重写，并同步 README / 章节入口 / 纸书推荐文案
• ✅ v1.9（2026-04-04）：同步橙皮书 v1.3~v1.4 更新——新增微信ClawBot、腾讯全家桶、浏览器渠道、GLM-5-Turbo、安全漏洞统计
• ✅ v1.6（2026-03-18）：新增一键部署教程（8个平台）
• 🔄 后续：继续清理第 3/4/6/9 章与 tutorials/ 中的旧截图、旧渠道步骤

📄 许可证

本项目采用 GPL-3.0 License

⚠️ 重要声明：禁止倒卖

• ❌ 严禁倒卖：禁止将本教程打包后进行商业售卖
• ❌ 严禁闭源商用：任何基于本项目的衍生作品必须同样开源
• ✅ 允许学习：欢迎个人学习和使用
• ✅ 允许分享：欢迎分享给更多需要的人
• ✅ 允许修改：可以修改并分享，但必须保持开源