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…

What is this?It is a large, continuously-updated Chinese-language tutorial for OpenClaw, a personal AI agent/assistant platform — covering installation, configuration, Skills, Feishu integration and common pitfalls. It has also been published as a physical book, 'OpenClaw超级个体实操手册 (OpenClaw Super Individual Handbook)', by Tsinghua University Press.
Is OpenClaw's actual source code in this repo, or is this just documentation about it?This repo is pure documentation (mostly Markdown chapters with some Shell), not the OpenClaw application itself. OpenClaw is a separate AI agent platform you deploy via Feishu, a hosting panel, Docker/K8s, or desktop clients, and this repo only explains how to set it up and use it.
How do I actually deploy OpenClaw by following this guide?The README gives a 30-second decision table matching your situation to a deployment path — e.g. Feishu 妙搭 for the fastest free start, 宝塔面板 if you have a server, JVSClaw for enterprise-grade security, or QClaw for a native macOS client — then points you to Chapter 2 for the full walkthrough.
What runtime does OpenClaw itself need to run?OpenClaw's recommended runtime is Node 24; if you need backward compatibility, Node 22.19+ is the minimum. You can verify your installed version with 'npm view openclaw version'.
Is every chapter of this tutorial up to date with the latest OpenClaw version?No — only chapters 1/2/5/8/10-15 are synced to the current v2026.6.8 mainline. Other chapters still contain older cases, screenshots and Skill names from earlier releases that should be treated as reference only, not copied directly.
Who is this guide written for?It targets 'super individuals' who want to run solo operations at team-level efficiency, complete beginners who need hand-held setup, knowledge workers wanting a 10x productivity boost, and developers/creators who want to dig into Skills development and automation.
What is OpenClaw?OpenClaw is an AI personal assistant/agent platform (an 'AI employee') that can be hooked up to chat tools like Feishu, WeChat Work, DingTalk, QQ and WeChat to handle file management, scheduling, a personal knowledge base, and automated workflows.
Why pay for the physical book if the tutorial is free?The printed edition is a full rewrite with every one of 144 CLI commands checked against the official docs (about 60% of the free tutorial's commands turned out outdated or wrong), plus 9 verified config templates and extra security guidance not in the repo.
How much does it cost to actually run OpenClaw day to day?It depends on deployment: Feishu hosting is free, a self-hosted cloud server runs about 20-50 RMB/month, a local Mac deployment is free, and model API usage costs roughly 5-50 RMB/month depending on the provider, with domestic models like DeepSeek cutting costs 50-70%.
How many Skills does the OpenClaw ecosystem have?The ecosystem lists over 1,800 Skills (extensions/integrations), which Chapter 8 of the tutorial covers for discovery, vetting, and installation.
Creator
xianyu110
Size
144.1 MB
Stars
4.6K
Age
8mo
Commits · 90 Days