OpenClaw 中文教程（4500+ Star · 已出版纸质书）：安装、配置、Skills、飞书接入与避坑｜作者的 GPT-6 / Codex / Claude Code 新项目见 README 顶部
See the code从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南
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。
为了避免你把旧章节当成最新版官方教程，先看这 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官方推荐步骤。
| 你的情况 | 推荐方案 | 为什么 | 开始时间 |
|---|---|---|---|
| 完全小白，想最快体验 | 飞书妙搭 ⭐ | 免费 + 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元/月起 |
找不到答案？
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
症状：只能聊天不能干活（文件管理、命令执行失效）
原因：默认profile改为 messaging（纯聊天模式）
修复：切换到 full profile
openclaw config set tools.profile full
openclaw gateway restart
5种Profile说明：
| Profile | 功能说明 |
|---|---|
messaging | 只能发布消息、管理会话 |
default | 默认工具集（不含命令执行） |
coding | 编程相关工具 |
full | 完整工具集，包含命令执行（推荐） |
all | 所有工具全开 |
建议所有用户升级，包含大量安全修复
新功能
/fast 快速模式开关：支持切换 OpenAI / Anthropic 的 fast tier，更省钱更快sessions_yield 工具：Agent 可立即结束当前轮次并携带后续载荷，流程控制更灵活重要安全修复（建议立即升级）
/config、/debug 权限绕过新功能
OPENCLAW_TZ 环境变量Bug 修复
当前基线
v2026.9.3Node 26（或 Node 24.16+）；不再支持 Node 22npm view openclaw version 应返回 2026.9.3updates/2026-09-10-v2026.9.3.md从 2026.6.8 跳到 2026.9.3，教学上最关键的变化
codex/*、openai-codex/* → openai/*（openclaw doctor --fix）/prose 下线；清配置用 Doctor，需要时再装上游 Agent Skillopenclaw skills；Workshop 按 Agent 持久化；clawhub install … 降为历史参考openclaw update statusinfer、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 openclaw@2026.9.3 --allow-scripts=openclaw兜底。升级后先跑openclaw doctor --fix、openclaw models status --probe和openclaw channels status。
以下内容保留为历史对照，不再作为当前推荐基线。
openclaw infer、内建媒体与 /usage footer 等主线openai-codex/* 或整串 clawhub install …，请按上文迁移到 2026.9 主线⚠️ 当前说明：开源教程的第 1/2/5/7/8/10~15 章已按 v2026.9.3 主线修订；纸质书仍然是更系统的重写版，适合需要完整、稳定、逐条验证内容的读者。
纸质书已全面修正，现已上市！
清华大学出版社出版《OpenClaw超级个体实操手册》，在开源教程基础上做了全面重写+逐条验证：
🛒 购买链接：京东专属链接（¥42，原价¥59.8）
📦 本地一键部署安装包：https://tryopenclaw.asia/
| 方案 | 月费用 | 适用场景 |
|---|---|---|
| 飞书妙搭 | 免费 | 新手推荐（限时） |
| 云端部署 | 20-50元 | 无Mac/24小时运行 |
| 本地部署 | 0元 | 有Mac电脑 |
| API费用（DeepSeek） | 5-30元 | 日常使用 |
| API费用（Kimi） | 10-50元 | 长文档处理 |
💡 省钱技巧：使用国产大模型（DeepSeek、Kimi）节省**50%-70%**成本
欢迎贡献你的经验和案例！
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)v2026.9.3，覆盖 README / 安装升级 / 模型路由迁移 / Doctor / 关键章节基线，并新增 updates/2026-09-10-v2026.9.3.mdv2026.6.8 稳定版，更新安装升级命令、版本基线、模型/渠道/usage/search 说明10~15 章按 OpenClaw v2026.4.14 稳定版主线重写，并同步 README / 章节入口 / 纸书推荐文案3/4/6/9 章与 tutorials/ 中的旧截图、旧渠道步骤本项目采用 GPL-3.0 License
最后更新：2026年9月10日 教程版本：v1.12 总字数：408,000字（15章节 + 15附录） 适用OpenClaw版本：2026.9.3（稳定版）
🎉 教程已完成 | 支持续优化 | 完全免费 🎉 🚀 一个人 + OpenClaw = 无限可能 🚀 ⭐ 如果觉得有用，请给个Star支持一下 ⭐
OpenClaw 中文教程（4500+ Star · 已出版纸质书）：安装、配置、Skills、飞书接入与避坑｜作者的 GPT-6 / Codex / Claude Code 新项目见 README 顶部
See the code从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南
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。
为了避免你把旧章节当成最新版官方教程，先看这 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官方推荐步骤。
| 你的情况 | 推荐方案 | 为什么 | 开始时间 |
|---|---|---|---|
| 完全小白，想最快体验 | 飞书妙搭 ⭐ | 免费 + 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元/月起 |
找不到答案？
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
症状：只能聊天不能干活（文件管理、命令执行失效）
原因：默认profile改为 messaging（纯聊天模式）
修复：切换到 full profile
openclaw config set tools.profile full
openclaw gateway restart
5种Profile说明：
| Profile | 功能说明 |
|---|---|
messaging | 只能发布消息、管理会话 |
default | 默认工具集（不含命令执行） |
coding | 编程相关工具 |
full | 完整工具集，包含命令执行（推荐） |
all | 所有工具全开 |
建议所有用户升级，包含大量安全修复
新功能
/fast 快速模式开关：支持切换 OpenAI / Anthropic 的 fast tier，更省钱更快sessions_yield 工具：Agent 可立即结束当前轮次并携带后续载荷，流程控制更灵活重要安全修复（建议立即升级）
/config、/debug 权限绕过新功能
OPENCLAW_TZ 环境变量Bug 修复
当前基线
v2026.9.3Node 26（或 Node 24.16+）；不再支持 Node 22npm view openclaw version 应返回 2026.9.3updates/2026-09-10-v2026.9.3.md从 2026.6.8 跳到 2026.9.3，教学上最关键的变化
codex/*、openai-codex/* → openai/*（openclaw doctor --fix）/prose 下线；清配置用 Doctor，需要时再装上游 Agent Skillopenclaw skills；Workshop 按 Agent 持久化；clawhub install … 降为历史参考openclaw update statusinfer、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 openclaw@2026.9.3 --allow-scripts=openclaw兜底。升级后先跑openclaw doctor --fix、openclaw models status --probe和openclaw channels status。
以下内容保留为历史对照，不再作为当前推荐基线。
openclaw infer、内建媒体与 /usage footer 等主线openai-codex/* 或整串 clawhub install …，请按上文迁移到 2026.9 主线⚠️ 当前说明：开源教程的第 1/2/5/7/8/10~15 章已按 v2026.9.3 主线修订；纸质书仍然是更系统的重写版，适合需要完整、稳定、逐条验证内容的读者。
纸质书已全面修正，现已上市！
清华大学出版社出版《OpenClaw超级个体实操手册》，在开源教程基础上做了全面重写+逐条验证：
🛒 购买链接：京东专属链接（¥42，原价¥59.8）
📦 本地一键部署安装包：https://tryopenclaw.asia/
| 方案 | 月费用 | 适用场景 |
|---|---|---|
| 飞书妙搭 | 免费 | 新手推荐（限时） |
| 云端部署 | 20-50元 | 无Mac/24小时运行 |
| 本地部署 | 0元 | 有Mac电脑 |
| API费用（DeepSeek） | 5-30元 | 日常使用 |
| API费用（Kimi） | 10-50元 | 长文档处理 |
💡 省钱技巧：使用国产大模型（DeepSeek、Kimi）节省**50%-70%**成本
欢迎贡献你的经验和案例！
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)v2026.9.3，覆盖 README / 安装升级 / 模型路由迁移 / Doctor / 关键章节基线，并新增 updates/2026-09-10-v2026.9.3.mdv2026.6.8 稳定版，更新安装升级命令、版本基线、模型/渠道/usage/search 说明10~15 章按 OpenClaw v2026.4.14 稳定版主线重写，并同步 README / 章节入口 / 纸书推荐文案3/4/6/9 章与 tutorials/ 中的旧截图、旧渠道步骤本项目采用 GPL-3.0 License
最后更新：2026年9月10日 教程版本：v1.12 总字数：408,000字（15章节 + 15附录） 适用OpenClaw版本：2026.9.3（稳定版）
🎉 教程已完成 | 支持续优化 | 完全免费 🎉 🚀 一个人 + OpenClaw = 无限可能 🚀 ⭐ 如果觉得有用，请给个Star支持一下 ⭐