Skip to content

datawhalechina/hello-claw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hello Claw Logo

Hello Claw: 从零到一学习 OpenClaw

从零开始掌握 OpenClaw:领养你的 AI 龙虾助理,或从零构建属于你的智能体

📌 在线阅读

Stars Forks License

简体中文 English

Warning

🧪 Beta公测版本提示:教程主体已完成,正在优化细节,欢迎大家提Issue反馈问题或建议。

项目简介

本项目是一个面向 OpenClaw 的完整学习教程,帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率,还是想深入理解其原理并构建自己的版本,本教程都能为你提供清晰的学习路径。

本项目包含两大核心模块:

  1. 领养 Claw(使用篇):快速上手 OpenClaw,学会配置、使用和扩展这个 AI 助理
  2. 构建 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

📖 目录

第一部分:领养 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:学习资源汇总 官方文档、社区链接和推荐学习路径 🚧

第二部分:构建 Claw

章节 简介 状态
写在开头 为什么要从零构建 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 开源项目指南进行操作即可

📧 关注我们

扫描下方二维码关注公众号:Datawhale

📄 LICENSE


⭐ 如果这个项目对你有帮助,请给我们一个 Star ❤️

About

首个体系化 openclaw 中文开源教程 | Adopt from scratch and build your first claw 🦞 零基础领养、构建你的第一只龙虾

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages