awesome-openclaw-tutorial README

The project's README from github.com/xianyu110/awesome-openclaw-tutorial. As one markdown file: README.md.

🦞 Awesome OpenClaw Tutorial

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

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

GitHub stars GitHub forks License Version Status CSDN Bilibili 微信公众号 YouTube X

📖 纸质书《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。

🔗 MaynorAI 高星项目导航

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

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

类型 本教程当前状态 阅读建议
版本基线 已对齐 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+ 官方推荐步骤。


🚀 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月)

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

新功能

重要安全修复(建议立即升级)


🆕 v2026.3.13 更新(2026年3月中旬)

新功能

Bug 修复


🆕 v2026.6.8 稳定版更新(2026年6月16日)

当前基线

2026.6 主线变化

升级命令:

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。


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

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

纸质书已全面修正,现已上市!

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

🛒 购买链接:京东专属链接(¥42,原价¥59.8)

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


📖 关于本教程

🎯 教程特色

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

📊 教程规模

🎯 适合人群


📚 完整教程目录

第一部分:零基础入门(3章节)

第二部分:核心功能(4章节)

第三部分:进阶技能(4章节)

第四部分:实战案例(4章节)


🔗 官方资源

💡 实战案例精选

📦 配置示例(开箱即用)

🎬 实战场景


📊 成本对比

方案 月费用 适用场景
飞书妙搭 免费 新手推荐(限时)
云端部署 20-50元 无Mac/24小时运行
本地部署 0元 有Mac电脑
API费用(DeepSeek) 5-30元 日常使用
API费用(Kimi) 10-50元 长文档处理

💡 省钱技巧:使用国产大模型(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

📮 联系方式

社交媒体

awesome-openclaw-tutorial (xianyu110/awesome-openclaw-tutorial)

Searching Database…

这是什么?这是一份持续更新的大型中文教程,面向个人 AI 智能体/助手平台 OpenClaw——涵盖安装、配置、Skills、飞书集成和常见坑点。它还由清华大学出版社出版了实体书《OpenClaw超级个体实操手册 (OpenClaw Super Individual Handbook)》。
OpenClaw 的实际源代码在这个仓库里吗,还是这里只有关于它的文档?这个仓库是纯文档(绝大部分是 Markdown 章节,外加一些 Shell),并不是 OpenClaw 应用本身。OpenClaw 是一个独立的 AI 智能体平台,你可以通过飞书、托管面板、Docker/K8s 或桌面客户端部署它,这个仓库只讲解如何搭建和使用。
按照这份指南实际要怎么部署 OpenClaw?README 提供了一张 30 秒决策表,把你的情况对应到一条部署路线——例如想最快免费上手选 Feishu 妙搭,有服务器选宝塔面板,追求企业级安全选 JVSClaw,想要原生 macOS 客户端选 QClaw——然后指引你到第 2 章查看完整流程。
OpenClaw 本身需要什么运行环境?OpenClaw 推荐的运行时是 Node 24;如果需要向后兼容,Node 22.19+ 是最低要求。可以用“npm view openclaw version”核实你安装的版本。
这份教程的每一章都与最新的 OpenClaw 版本同步吗?不是——只有第 1/2/5/8/10-15 章与当前的 v2026.6.8 主线同步。其他章节仍包含早期版本中的旧案例、截图和 Skill 名称,只能当作参考,不要直接照搬。
这份指南是写给谁的?它面向想以团队级效率独立运营的“超级个体”、需要手把手教学的零基础新手、想获得 10 倍生产力提升的知识工作者,以及想深入钻研 Skills 开发和自动化的开发者/创作者。
OpenClaw 是什么?OpenClaw 是一个 AI 个人助理/智能体平台(一名“AI 员工”),可以接入飞书、企业微信、钉钉、QQ 和微信等聊天工具,处理文件管理、日程安排、个人知识库和自动化工作流。
教程免费,为什么还要花钱买实体书?印刷版是一次全面重写,144 条 CLI 命令逐条对照官方文档核查过(免费教程中的命令约有 60% 已过时或有误),还包含 9 份经过验证的配置模板以及仓库中没有的额外安全指引。
日常运行 OpenClaw 实际要花多少钱?取决于部署方式:飞书托管免费,自建云服务器每月约 20-50 元人民币,本地 Mac 部署免费;模型 API 用量视服务商而定,每月大约 5-50 元人民币,DeepSeek 等国产模型可节省 50-70% 的成本。
OpenClaw 生态有多少个 Skills?生态中列出了超过 1,800 个 Skills(扩展/集成),教程第 8 章讲解了如何发现、甄别和安装它们。
Creator
xianyu110
Size
144.1 MB
Stars
4.6K
Age
8mo
Commits · 90 Days