Warning
🧪 Beta公测版本提示:教程主体已完成,正在优化细节,欢迎大家提Issue反馈问题或建议。
本项目是一个面向 OpenClaw 的完整学习教程,帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率,还是想深入理解其原理并构建自己的版本,本教程都能为你提供清晰的学习路径。
本项目包含两大核心模块:
- 领养 Claw(使用篇):快速上手 OpenClaw,学会配置、使用和扩展这个 AI 助理
- 构建 Claw(开发篇):从零实现一个简化版 AI Agent,深入理解其工作原理
谁适合学习:
- 想要一个随时待命的 AI 命令行助手的开发者
- 希望通过 Telegram/飞书远程控制 AI 的效率达人
- 对 OpenClaw 的技能系统和自动化能力感兴趣的学习者
- 想要理解并构建自己的 AI Agent 工具的技术爱好者
学习建议:
- 零基础用户:从第一部分"领养 Claw"开始,逐步掌握使用方法
- 开发者:可直接进入第二部分"构建 Claw",理解底层实现原理
- [2026-03-06] ✅ 完成第1-3章:安装配置、移动端接入(Telegram/飞书/QQ)、自动化任务
- [2026-03-04] 🦞 项目启动,规划"领养 Claw"和"构建 Claw"两大核心模块
https://datawhalechina.github.io/hello-claw
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | OpenClaw 是什么、为什么要学习它以及如何使用本教程 | ✅ |
| 快速上手 | ||
| 第一章 十分钟上手 OpenClaw | Node.js 安装、OpenClaw 配置、常用命令和 Coding Plan 模式 | ✅ |
| 第二章 移动端接入 | 通过 Telegram、飞书和 QQ 实现随时随地的移动端控制 | ✅ |
| 第三章 自动化任务入门 | 创建定时提醒、自动化报告和周期性工作流 | ✅ |
| 第四章 Skills 技能系统 | 理解技能概念、安装市场技能和开发自定义技能 | 🚧 |
| 进阶实战 | ||
| 第五章 外部服务集成 | 连接 Gmail、Google Calendar、文件系统和其他第三方服务 | 🚧 |
| 第六章 生产环境部署 | VPS 选择、远程部署、Docker 隔离和 24/7 运行配置 | 🚧 |
| 第七章 多模型与成本优化 | 配置多个 LLM 模型、本地 Ollama 部署和 API 费用控制 | 🚧 |
| 应用场景 | ||
| 第八章 个人助理系统 | 邮件管理、日程安排、信息整理和智能提醒的完整实现 | 🚧 |
| 第九章 内容创作工具链 | 写作辅助、灵感收集、素材管理和自动发布流程 | 🚧 |
| 第十章 开发者效率提升 | 代码生成、Git 自动化、文档生成和测试辅助 | 🚧 |
| 第十一章 故障排查与优化 | 常见问题解决、性能调优和社区资源利用 | 🚧 |
| 附录 | ||
| 附录 A:命令速查表 | 常用命令行工具完整参考 | 🚧 |
| 附录 B:配置文件详解 | 配置文件各项参数说明 | 🚧 |
| 附录 C:技能开发模板 | 技能开发示例代码和最佳实践 | 🚧 |
| 附录 D:学习资源汇总 | 官方文档、社区链接和推荐学习路径 | 🚧 |
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | 为什么要从零构建 AI Agent、Nanobot 的 400 行实现和学习路线图 | 🚧 |
| 基础实现 | ||
| 第一章 Hello Agent | 50 行代码连接 LLM API 实现第一次对话 | 🚧 |
| 第二章 工具调用 | 实现 read 工具、解析 Function Calling 并执行 | 🚧 |
| 第三章 Agent Loop | 实现循环直到任务完成的 Agent 主循环 | 🚧 |
| 第四章 Bash 工具 | 添加执行 Shell 命令的能力 | 🚧 |
| 技能系统 | ||
| 第五章 解析 SKILL.md | 实现 YAML frontmatter 和 Markdown 指令解析器 | 🚧 |
| 第六章 技能加载与触发 | 扫描技能目录、环境变量注入和自动激活 | 🚧 |
| 第七章 编写第一个技能 | 从零编写一个天气查询技能 | 🚧 |
| 消息网关 | ||
| 第八章 Telegram Bot | 接入 Telegram 实现移动端控制 | 🚧 |
| 第九章 消息路由 | 设计统一的消息适配器处理多渠道输入 | 🚧 |
| 第十章 飞书集成 | 添加飞书渠道支持企业场景 | 🚧 |
| 记忆与自动化 | ||
| 第十一章 对话历史与 SOUL.md | 实现短期记忆、解析 Agent 身份和行为指令 | 🚧 |
| 第十二章 MEMORY.md 持久化 | 实现长期记忆的读写和自动更新 | 🚧 |
| 第十三章 Cron 调度器 | 实现定时任务的解析、调度和执行 | 🚧 |
| 第十四章 OpenClaw 源码导读 | 克隆 OpenClaw 仓库、理解目录结构、核心模块解析和关键代码走读 | 🚧 |
| 附录 | ||
| 附录 A:完整代码仓库 | 每章的完整代码和可运行示例 | 🚧 |
| 附录 B:技能开发指南 | 10 个从简单到复杂的技能示例 | 🚧 |
| 附录 C:架构对比 | OpenClaw vs Nanobot 的设计权衡 | 🚧 |
欢迎贡献你的龙虾使用方法!如果你有独特的 OpenClaw 使用场景,欢迎提交 PR 或 Issue 分享。
|
🌅 个人效率 • 早间简报(天气+日程+待办) • 邮件自动分类与摘要 • 智能日程管理 |
💻 编程开发 • 代码生成与审查 • 自动化测试与部署 • 文档自动生成 |
📢 内容创作 • 社交媒体自动运营 • 写作辅助与润色 • 多平台内容发布 |
|
🏢 商务销售 • 客户支持与CRM管理 • 销售线索自动跟进 • 会议预约与纪要 |
🤖 多智能体协作 • 智能体团队项目管理 • 自动化工作流编排 • 知识库共享与检索 |
🔧 更多场景 • 智能家居控制 • 金融数据分析 • 教育培训辅助 |
| 姓名 | 职责 | 简介 |
|---|---|---|
| 散步 | 项目负责人 | Datawhale 成员 |
欢迎更多贡献者加入
- 如果你发现了一些问题,可以提 Issue 进行反馈,如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你想参与贡献本项目,可以提 Pull Request,如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你对 Datawhale 很感兴趣并想要发起一个新的项目,请按照 Datawhale 开源项目指南进行操作即可

