一个不起眼的仓库里，龙虾诞生了。
选一只，送它上学堂；或动手写一只不被定义的龙虾。
它的梦想，从第一天起就很大。
Hello Claw：领养你的 AI 龙虾助理，上龙虾大学学 Skills，从零构建属于你的智能助理
📌 在线阅读 | 💬 加入交流群 | 🚀 还想学 vibecoding
Warning
🧪 Beta公测版本提示：教程主体已完成，正在优化细节，欢迎大家提Issue反馈问题或建议。
https://datawhalechina.github.io/hello-claw
本项目是一个面向 OpenClaw 的完整学习教程，帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率，还是想深入理解其原理并构建自己的版本，本教程都能为你提供清晰的学习路径。
本项目包含三大核心模块：
- 领养龙虾（使用篇）：11 章 + 7 个附录，安装（Ch1-3）+ 核心配置（Ch4-6）+ 扩展运维（Ch7-9）+ 安全与客户端（Ch10-11），按需选读
- 龙虾大学（场景实战篇）：围绕 Skills 选型与典型工作流，给出可直接复用的实战案例
- 构建龙虾（开发篇）：15 章，先拆解 OpenClaw 源码与替代方案，再进入 Skills、渠道和完整定制
谁适合学习：
- 零基础用户：想要一个随时待命的 AI 助手，不需要任何编程经验
- 效率达人：希望通过 QQ / 飞书 / Telegram 远程控制 AI
- 技术爱好者：对 OpenClaw 的技能系统和自动化能力感兴趣
- 开发者：想深入理解 Agent 架构并构建自己的版本
学习建议：
- 零基础用户：从第一部分“领养龙虾”开始，先把安装与基础自动化跑通
- 想做场景闭环：直接进入“龙虾大学”，按场景挑 5~10 个 Skills 快速落地
- 开发者：进入“构建龙虾”，拆解底层实现原理并定制自己的 Claw
- [2026-03-12] ✅ 完成构建 Claw 第1-10章：核心架构解析（提示词系统、工具系统、消息循环、多渠道接入）、替代方案探索（轻量化、安全加固、硬件方案）、站在山巅回望总结
- [2026-03-10] ✅ 完成构建 Claw 第13章：Skill 文件结构、Frontmatter、异步处理与调试
- [2026-03-10] ✅ 新增龙虾大学：菜单式 Skills 选修指南，让龙虾装上"战斗外挂"
- [2026-03-08] ✅ 完成领养 Claw 第1-11章：安装（AutoClaw + 手动安装 + 配置向导）、核心配置（聊天平台、模型、智能体）、扩展运维（工具与定时任务、网关、远程访问）、安全与客户端（安全防护、Web 界面）
- [2026-03-04] 🦞 项目启动，规划"领养 Claw"和"构建 Claw"两大核心模块
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | OpenClaw 是什么、领养四步法、学习路线图 | ✅ |
| 🔵 安装 | ||
| 第 1 章 AutoClaw 一键安装 | 下载 AutoClaw 桌面客户端，5 分钟零门槛体验 | ✅ |
| 第 2 章 OpenClaw 手动安装 | 终端介绍、Node.js 安装、npm install、onboard 配置向导 | ✅ |
| 第 3 章 初始配置向导 | CLI 向导、macOS 引导、Custom Provider、重新配置 | ✅ |
| 🟢 核心配置 | ||
| 第 4 章 聊天平台接入 | 支持平台总览、以飞书为例完整接入、配对与群聊 | ✅ |
| 第 5 章 模型管理 | 模型概念、CLI 管理、多提供商配置、API Key 轮换、故障转移 | ✅ |
| 第 6 章 智能体管理 | 多 Agent 管理、工作区、心跳、绑定规则 | ✅ |
| 🟡 扩展运维 | ||
| 第 7 章 工具与定时任务 | 工具集级别、定时任务（cron/at/every）、Web 搜索 | ✅ |
| 第 8 章 网关运维 | 启动管理、热更新、认证安全、密钥管理、沙箱策略、日志监控 | ✅ |
| 第 9 章 远程访问与网络 | SSH 隧道、Tailscale 组网、部署架构、安全最佳实践 | ✅ |
| 🔴 安全与客户端 | ||
| 第 10 章 安全防护与威胁模型 | 威胁全景、VM 隔离、信任边界、MITRE ATLAS、供应链安全 | ✅ |
| 第 11 章 Web 界面与客户端 | Dashboard、WebChat、Control UI、TUI、第三方客户端 | ✅ |
| 附录 | ||
| 附录 A：学习资源汇总 | 8 大类学习资源，80+ 链接，编者精选 | ✅ |
| 附录 B：社区之声与生态展望 | 6 大议题深度讨论 + 金句精选 | ✅ |
| 附录 C：类 Claw 方案对比与选型 | 桌面客户端 / 托管服务 / 云厂商 / 开源自建 / 移动端 5 大类 | ✅ |
| 附录 D：技能开发与发布指南 | SKILL.md 格式 + skill-creator + ClawHub 发布流程 | ✅ |
| 附录 E：模型提供商选型指南 | 聚合网关 / 国内 / 国际 / 本地 4 大类系统对比 | ✅ |
| 附录 F：命令速查表 | 安装、配置、日志、cron、渠道等全部 CLI 命令参考 | ✅ |
| 附录 G：配置文件详解 | openclaw.json 各项参数逐项解读 | ✅ |
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | 为什么要从零构建你的 Claw、OpenClaw 复杂度困境与学习路线图 | ✅ |
| 🔵 OpenClaw 内部拆解（第 1～7 章） | ||
| 第 1 章 架构设计哲学 | AI Agent 架构演化、OpenClaw 六大架构创新 | ✅ |
| 第 2 章 ReAct 循环 | Agent 的"思考-行动"引擎、循环执行流程 | ✅ |
| 第 3 章 提示词系统 | 提示词架构与热更新机制、持久人格设计 | ✅ |
| 第 4 章 工具系统 | 四大原语工具详解、工具注册与组合能力 | ✅ |
| 第 5 章 消息循环与事件驱动 | 泳道模型、心跳机制、并发安全与时间主动性 | ✅ |
| 第 6 章 统一网关 | Gateway 架构、多渠道接入与消息标准化 | ✅ |
| 第 7 章 安全沙箱 | 自由与约束的平衡、执行环境隔离与权限控制 | ✅ |
| 🟢 定制方案（第 8～10 章） | ||
| 第 8 章 轻量化方案 | NanoClaw、Nanobot、ZeroClaw 等社区变体 | ✅ |
| 第 9 章 安全加固方案 | IronClaw 安全架构、沙箱隔离与审计日志 | ✅ |
| 第 10 章 硬件方案 | PicoClaw 硬件选型、低功耗嵌入式部署 | ✅ |
| 🟡 第三层：定制你的 Claw（第 11～15 章） | ||
| 第 11 章 定制路径概览 | 四级定制难度、适用场景与维护成本、学习路线 | 🚧 |
| 第 12 章 配置文件级定制 | config.json 结构、工具白名单、安全配置 | 🚧 |
| 第 13 章 Skill 编写 | Skill 文件结构、Frontmatter 格式、异步处理与调试 | ✅ |
| 第 14 章 渠道接入 | 钉钉/飞书接入流程、渠道适配器编写、多渠道配置 | 🚧 |
| 第 15 章 完整定制案例 | 编程助手、个人效率助手、智能客服机器人实战 | 🚧 |
| 文章 | 简介 | 状态 |
|---|---|---|
| 龙虾大学首页（Skills 选修指南） | ClawHub 与 SkillHub 双入口、技能分类地图、选课原则与推荐课表 | ✅ |
| Vibe Coding 实战 | 飞书对话驱动需求到 PR，全流程“对话即开发”闭环 | ✅ |
| 邮箱助手实战（163） | 从 IMAP/SMTP 配置到脚本验证与 cron 定时，跑通邮件自动化 | ✅ |
| 多智能体协作（Multi OpenClaw / HiClaw） | 从单 Worker 瓶颈到多智能体协作，落地可追踪的任务编排 | ✅ |
| 安全防护清单 | 技能与工具的安全边界、审计与防注入要点 | ✅ |
🎉 欢迎大家来贡献案例！
如果你有独特的 OpenClaw 使用场景或实践经验，欢迎通过以下方式分享：
- 提交 PR 添加你的案例到本章节
- 提 Issue 描述你的使用场景
- 加入社区讨论，与其他开发者交流
每一份贡献都能帮助更多人发现 OpenClaw 的可能性！
|
🌅 个人效率 • 早间简报（天气+日程+待办） • 邮件自动分类与摘要 • 智能日程管理 |
💻 编程开发 • 代码生成与审查 • 自动化测试与部署 • 文档自动生成 |
📢 内容创作 • 社交媒体自动运营 • 写作辅助与润色 • 多平台内容发布 |
|
🏢 商务销售 • 客户支持与CRM管理 • 销售线索自动跟进 • 会议预约与纪要 |
🤖 多智能体协作 • 智能体团队项目管理 • 自动化工作流编排 • 知识库共享与检索 |
🔧 更多场景 • 智能家居控制 • 金融数据分析 • 教育培训辅助 |
| 姓名 | 职责 | 简介 |
|---|---|---|
| 桂子轩 | 核心贡献者 | - |
| 赵志民 | 核心贡献者 | - |
| 李秀奇 | 核心贡献者 | - |
| 刘丽欣 | 核心贡献者 | - |
| 刘思怡 | 核心贡献者 | - |
| 散步 | 核心贡献者 | - |
欢迎更多贡献者加入
- 如果你发现了一些问题，可以提 Issue 进行反馈，如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你想参与贡献本项目，可以提 Pull Request，如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你对 Datawhale 很感兴趣并想要发起一个新的项目，请按照 Datawhale 开源项目指南进行操作即可
<a id="交流群"></a>
欢迎加入 Hello Claw 交流群，与其他开发者一起探讨学习：
扫描下方二维码关注公众号：Datawhale
