🦞 Awesome OpenClaw Tutorial
🦞 一本书玩转OpenClaw：超级个体实战指南
从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南
🔥 2026 年 10 月 · 作者正在更新的新项目
OpenClaw 教程继续保留在下方 👇。这里先列出作者近期正在维护的新仓库，内容方向相近，欢迎顺手看看、点个 Star。
🦞 以下为 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元/月起 |
📖 查看完整一键部署教程 →
📊 教程导航（按学习路径）
🎯 零基础入门（必读）
🔥 核心功能（实战）
💎 进阶技能（提升）
🎯 实战案例（直接套用）
📚 附录工具（速查）
🆘 遇到问题？快速解决
🔧 常见问题速查（点击展开）
安装配置问题
使用问题
成本优化
找不到答案？
🚨 重要版本提示
⚠️ 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日）
当前基线
从 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/
📖 关于本教程
🎯 教程特色
- 超级个体定位 - 一个人+OpenClaw=无限可能，效率提升10倍
- 云端部署优先 - 降低技术门槛，手机随时使用
- 国产模型为主 - 成本低、速度快、中文友好
- 实战案例丰富 - 70+完整工作流，可直接应用
- 中国本土化 - 企业微信/钉钉/飞书深度集成
- 完整资源导航 - 官方资源、社区资源、学习路径
📊 教程规模
- ✅ 15章节正文：约267,000字
- ✅ 15个附录：约141,000字
- ✅ 总字数：408,000字
- ✅ 70+实战案例：可直接应用
- ✅ 完整配图：50+张配置截图
🎯 适合人群
- 🚀 超级个体：想要一个人顶一个团队，实现个人价值最大化
- 🔰 完全新手：从零开始，手把手教你安装配置
- 💼 知识工作者：学习如何用OpenClaw提升10倍个人效率
- 👨💻 开发者：深入了解Skills开发和API集成
- ✍️ 内容创作者：探索自动化工作流和高级应用
📚 完整教程目录
第一部分：零基础入门（3章节）
第二部分：核心功能（4章节）
第三部分：进阶技能（4章节）
第四部分：实战案例（4章节）
🔗 官方资源
💡 实战案例精选
📦 配置示例（开箱即用）
🎬 实战场景
📊 成本对比
| 方案 |
月费用 |
适用场景 |
| 飞书妙搭 |
免费 |
新手推荐（限时） |
| 云端部署 |
20-50元 |
无Mac/24小时运行 |
| 本地部署 |
0元 |
有Mac电脑 |
| API费用（DeepSeek） |
5-30元 |
日常使用 |
| API费用（Kimi） |
10-50元 |
长文档处理 |
💡 省钱技巧：使用国产大模型（DeepSeek、Kimi）节省**50%-70%**成本
🤝 贡献指南
欢迎贡献你的经验和案例！
- Fork本仓库
- 创建你的分支 (
git checkout -b feature/AmazingFeature)
- 提交你的修改 (
git commit -m 'Add some AmazingFeature')
- 推送到分支 (
git push origin feature/AmazingFeature)
- 提交Pull Request
📮 联系方式
社交媒体
项目链接
📈 项目进度
- ✅ 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
⚠️ 重要声明：禁止倒卖
- ❌ 严禁倒卖：禁止将本教程打包后进行商业售卖
- ❌ 严禁闭源商用：任何基于本项目的衍生作品必须同样开源
- ✅ 允许学习：欢迎个人学习和使用
- ✅ 允许分享：欢迎分享给更多需要的人
- ✅ 允许修改：可以修改并分享，但必须保持开源
最后更新：2026年9月10日
教程版本：v1.12
总字数：408,000字（15章节 + 15附录）
适用OpenClaw版本：2026.9.3（稳定版）
🎉 教程已完成 | 支持续优化 | 完全免费 🎉
🚀 一个人 + OpenClaw = 无限可能 🚀
⭐ 如果觉得有用，请给个Star支持一下 ⭐
评论