一个不起眼的仓库里，龙虾诞生了。
选一只，送它上学堂；或动手写一只不被定义的龙虾。
它的梦想，从第一天起就很大。
Hello Claw：领养你的 AI 龙虾助理，上龙虾大学学 Skills，从零构建属于你的智能助理
📌 在线阅读 | 还想学 Vibe Coding
https://datawhalechina.github.io/hello-claw
本项目是一个面向 OpenClaw 的完整学习教程，帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率，还是想深入理解其原理并构建自己的版本，本教程都能为你提供清晰的学习路径。
本项目包含三大核心模块：
- 领养龙虾（使用篇）：11 章 + 7 个附录，安装（Ch1-3）+ 核心配置（Ch4-6）+ 扩展运维（Ch7-9）+ 安全与客户端（Ch10-11），按需选读
- 龙虾大学（场景实战篇）：围绕 Skills 选型与典型工作流，给出可直接复用的实战案例
- 构建龙虾（开发篇）：11 章，先拆解 OpenClaw 源码与替代方案，再进入 Skills、渠道和完整定制
谁适合学习：
- 零基础用户：想要一个随时待命的 AI 助手，不需要任何编程经验
- 效率达人：希望通过 QQ / 飞书 / Telegram 远程控制 AI
- 技术爱好者：对 OpenClaw 的技能系统和自动化能力感兴趣
- 开发者：想深入理解 Agent 架构并构建自己的版本
学习建议：
- 零基础用户：从第一部分“领养龙虾”开始，先把安装与基础自动化跑通
- 想做场景闭环：直接进入“龙虾大学”，按场景挑 5~10 个 Skills 快速落地
- 开发者：进入“构建龙虾”，拆解底层实现原理并定制自己的 Claw
- [2026-03-25] ✅ 龙虾大学完成一轮场景扩充与新手化重写，新增个人效率、编程开发、内容创作、商务销售、多智能体协作和更多场景共 11 篇可直接上手的实战案例，并同步按 README 分类整理
- [2026-03-25] 🔥 OpenClaw v2026.3.24：Gateway OpenAI 兼容端点（
/v1/models、/v1/embeddings）、Microsoft Teams 官方 SDK 集成（流式回复/欢迎卡片/消息编辑删除）、Skills 一键安装配方与 Control UI 状态过滤、Slack 富回复恢复、CLI--container容器内执行、Discord LLM 自动线程命名、before_dispatch插件钩子、沙箱媒体安全修复，教程全章节同步 - [2026-03-23] 🔥 OpenClaw 3.22 大版本：插件 SDK 重构（旧 extension-api 废弃）、安全加固（SMB 凭证泄露/环境变量注入/Unicode 伪装等修复）、GPT-5.4 默认上位、飞书交互卡片/Telegram 话题自动命名、Agent 超时延长至 48h
- [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"两大核心模块
|
🌅 个人效率 • 邮箱助手实战（163） • Skill 开发实战：本地健康管理助手 • 早间简报自动化 • 智能日程管理 |
💻 编程开发 • Vibe Coding 实战 • 自动化测试与部署：CI/CD 助手实战 • 文档自动生成：从代码变更到可发布文档 |
📢 内容创作 • 自动化科研实战 • 内容创作工作室：社媒运营、写作润色与多平台发布 |
|
🏢 商务销售 • 商务销售实战：客户支持与 CRM 协同助手 • 商务销售实战：会议预约与纪要自动化 |
🤖 多智能体协作 • 多智能体协作（Multi OpenClaw / HiClaw） • 多智能体协作实战：知识库共享与检索 • 一人公司实战（一个人，一支团队） |
🔧 更多场景 • 安全防护清单 • Agent 论文推送助手 • 更多场景实战：智能家居控制助手 • 更多场景实战：金融数据分析助手 • 更多场景实战：教育培训辅助助手 |
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | 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（开发篇，13章）
| 章节 | 简介 | 状态 |
|---|---|---|
| 写在开头 | 为什么要从零构建你的 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（第 13 章） | ||
| 第 13 章 Skill 编写 | Skill 文件结构、Frontmatter 格式、异步处理与调试 | ✅ |
🎉 欢迎大家来贡献案例！
如果你有独特的 OpenClaw 使用场景或实践经验，欢迎通过以下方式分享：
- 提交 PR 添加你的案例到本章节
- 提 Issue 描述你的使用场景
- 加入社区讨论，与其他开发者交流
每一份贡献都能帮助更多人发现 OpenClaw 的可能性！
| 姓名 | 职责 |
|---|---|
| 桂子轩 | 核心贡献者 |
| 赵志民 | 核心贡献者 |
| 李秀奇 | 核心贡献者 |
| 刘丽欣 | 核心贡献者 |
| 刘思怡 | 核心贡献者 |
| 散步 | 核心贡献者 |
欢迎更多贡献者加入
- 如果你发现了一些问题，可以提 Issue 进行反馈，如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你想参与贡献本项目，可以提 Pull Request，如果提完没有人回复你可以联系保姆团队的同学进行反馈跟进
- 如果你对 Datawhale 很感兴趣并想要发起一个新的项目，请按照 Datawhale 开源项目指南进行操作即可
扫描下方二维码关注公众号：Datawhale
