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

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

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


🚀 30秒快速选择:哪种部署方式适合你?

你的情况 推荐方案 为什么 开始时间
完全小白,想最快体验 飞书妙搭 免费 + 1分钟完成 + 每日100万Tokens → 立即开始
有服务器,想可视化管理 宝塔面板 免费插件 + 面板管理 + 一键安装 → 3分钟搞定
企业级,需要高安全性 JVSClaw 14天免费 + 6核12GB + 端到端加密 → 需邀请码
想用浏览器操控 Kimi Claw Kimi K2.5 + 浏览器控制 → 200元/月
量化交易/多IM 腾讯 WorkBuddy 桌面端Agent + 多IM支持 → 送5000积分
Agent生态丰富 扣子 OpenClaw 1800+Skills → 99元/月起

📖 查看完整一键部署教程 →


📊 教程导航(按学习路径)

🎯 零基础入门(必读)

🔥 核心功能(实战)

💎 进阶技能(提升)

🎯 实战案例(直接套用)

📚 附录工具(速查)


🆘 遇到问题?快速解决

🔧 常见问题速查(点击展开) ### 安装配置问题 - [安装失败怎么办?](/appendix/E-common-problems.html#安装配置问题) - [API连接失败?](/appendix/E-common-problems.html#api连接问题) - [飞书Bot不回复?](/docs/03-advanced/09-multi-platform-integration.html#常见问题) ### 使用问题 - [AI变"哑巴"了?](#🔧-202632-版本ai变哑巴了) → 切换到 `full` profile - [Gateway启动失败?](/appendix/E-common-problems.html#gateway问题) → 检查认证配置 ### 成本优化 - [API费用太高?](/docs/03-advanced/11-advanced-configuration.html#成本优化) - [如何省钱?](/appendix/F-best-practices.html) - 使用国产模型节省95%

找不到答案?


🚨 重要版本提示

⚠️ 2026.3.7版本:Gateway认证要求(Breaking Change)

Gateway认证现在必须显式设置 gateway.auth.modetokenpassword

快速修复

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.3.24 更新(2026年3月26日,当前最新)

重要变更

升级命令

npm install -g openclaw@latest
openclaw --version  # 确认版本为 2026.3.24

⚠️ WSL/Linux 安装提示:如升级后提示缺少 UI 资产,请确认 Node 版本 >= 22.14,然后重新执行 npm install -g openclaw@latest


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

⚠️ 重要提示:本教程从第10章开始存在skill找不到和配置参数错误的问题(#34

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

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

📅 预计上市时间:2026年3月底 ⭐ Star本仓库第一时间获取上市通知!


📖 关于本教程

🎯 教程特色

  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

📮 联系方式

社交媒体

项目链接


📈 项目进度


📄 许可证

本项目采用 GPL-3.0 License

⚠️ 重要声明:禁止倒卖


**最后更新**:2026年3月27日 **教程版本**:v1.7 **总字数**:408,000字(15章节 + 15附录) **适用OpenClaw版本**:2026.3.24(推荐最新版) 🎉 **教程已完成 | 支持续优化 | 完全免费** 🎉 🚀 **一个人 + OpenClaw = 无限可能** 🚀 ⭐ **如果觉得有用,请给个Star支持一下** ⭐