The project's README from github.com/xianyu110/awesome-openclaw-tutorial. As one markdown file: README.md.
从零开始打造你的AI工作助手:最全面的中文教程,涵盖安装、配置、实战案例和避坑指南
📖 纸质书《OpenClaw超级个体实操手册》已上市! 清华大学出版社出版,在开源教程基础上全面重写+逐条验证。🛒 京东专属购买链接(¥42,原价¥59.8)
🔄 2026-06-18 更新说明:本仓库当前按 OpenClaw v2026.6.8(稳定版,2026-06-16 发布) 校对;第
1/2/5/8/10~15章已同步新版主线,优先覆盖infer / models / cron / tasks / Task Flow / webhooks / Active Memory / Memory Wiki / 媒体能力 / 多渠道消息 / usage footer。
为了避免你把旧章节当成最新版官方教程,先看这 4 点:
v2026.6.8 稳定版校对;如果 GitHub Releases 或 npm 出现更高版本,请以官方 Release Notes 和官方文档为准README 与第 1/2/5/8/10~15 章已按 2026.6+ 当前主线修订;第 7 章仍保留 2026.4 主线补充openclaw onboard、openclaw models auth login --provider <provider>、openclaw infer ...、Task Flow、Webhooks、ComfyUI、/usage| 类型 | 本教程当前状态 | 阅读建议 |
|---|---|---|
| 版本基线 | 已对齐 v2026.6.8 |
新手优先按这个版本跑通 |
| 2026.6 新能力 | 多渠道消息、模型目录、usage footer、搜索默认策略 | 可作为升级后的重点验证项 |
| 安装/配置主线 | 已补新版入口 | 优先看第 2 章和第 11 章 |
| 媒体/创意能力 | 已补 infer / video_generate / music_generate / ComfyUI 主线 |
优先看第 10 章和第 14 章 |
| 旧 Skill 生态 | 仍有历史内容残留 | 先 search/info 验证,再决定是否安装 |
⚠️ 一句话判断:如果你看到
local-anthropic、local-google、bananapro-image-gen、video-agent、整串clawhub install ...,请先把它理解为“历史参考”,不要默认当成2026.6+官方推荐步骤。
| 你的情况 | 推荐方案 | 为什么 | 开始时间 |
|---|---|---|---|
| 完全小白,想最快体验 | 飞书妙搭 ⭐ | 免费 + 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.6.8Node 24;如继续走兼容路径,建议至少 Node 22.19+npm view openclaw version 应返回 2026.6.82026.6 主线变化
claim/evidence、矛盾/新鲜度管理成为主线能力openclaw infer:统一 model / image / audio / tts / video / web / embedding CLI 入口video_generate / music_generate 与 ComfyUI provider/plugin 已可直接使用/usage footer:用量信息支持统一 footer 渲染、默认模板和小数格式化,坏模板会给出警告升级命令:
openclaw update --tag 2026.6.8 --yes
openclaw update repair
openclaw --version # 确认版本为 2026.6.8
⚠️ 新手建议:如果你的目标是“按教程稳定跑通”,优先使用
v2026.6.8;如果openclaw update在本机失败,再用npm install -g [email protected] --force兜底。升级后先跑openclaw doctor、openclaw models status --probe和openclaw channels status。
⚠️ 当前说明:开源教程的第 1/2/5/8/10~15 章已按 v2026.6.8 主线修订;纸质书仍然是更系统的重写版,适合需要完整、稳定、逐条验证内容的读者。
纸质书已全面修正,现已上市!
清华大学出版社出版《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)