哈喽！龙虾 🙋‍♀️ Adopt from scratch and build your first claw 🦞 来领养你的第一只龙虾！

Hello Claw Logo

一个不起眼的仓库里，龙虾诞生了。
选一只，送它上学堂；或动手写一只不被定义的龙虾。
它的梦想，从第一天起就很大。

哈喽！龙虾 👋

Hello Claw：领养你的 AI 龙虾助理，上龙虾大学学 Skills，从零构建属于你的智能助理

[![Stars](https://img.shields.io/github/stars/datawhalechina/hello-claw?color=660874&style=for-the-badge&logo=star&logoColor=white&labelColor=1a1a2e)](https://github.com/datawhalechina/hello-claw/stargazers)
[![Forks](https://img.shields.io/github/forks/datawhalechina/hello-claw?color=660874&style=for-the-badge&logo=git-fork&logoColor=white&labelColor=1a1a2e)](https://github.com/datawhalechina/hello-claw/network/members)
[![License](https://img.shields.io/badge/License-CC_BY_NC_SA_4.0-4ecdc4?style=for-the-badge&logo=creative-commons&logoColor=white&labelColor=1a1a2e)](LICENSE)

在线阅读

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）](./docs/cn/university/email-assistant/index.md)  

  • [Skill 开发实战：本地健康管理助手](./docs/cn/university/local-health-assistant/index.md)  

  • [早间简报自动化](./docs/cn/university/daily-briefing/index.md)  

  • [智能日程管理](./docs/cn/university/calendar-ops/index.md)




  💻 编程开发  

  • [Vibe Coding 实战](./docs/cn/university/vibe-coding/index.md)  

  • [自动化测试与部署：CI/CD 助手实战](./docs/cn/university/ci-cd-assistant/index.md)  

  • [文档自动生成：从代码变更到可发布文档](./docs/cn/university/docs-automation/index.md)




  📢 内容创作  

  • [自动化科研实战](./docs/cn/university/vibe-research/index.md)  

  • [内容创作工作室：社媒运营、写作润色与多平台发布](./docs/cn/university/content-studio/index.md)








  🏢 商务销售  

  • [商务销售实战：客户支持与 CRM 协同助手](./docs/cn/university/revops-assistant/index.md)  

  • [商务销售实战：会议预约与纪要自动化](./docs/cn/university/meeting-ops/index.md)




  🤖 多智能体协作  

  • [多智能体协作（Multi OpenClaw / HiClaw）](./docs/cn/university/multi-claw-hiclaw/index.md)  

  • [多智能体协作实战：知识库共享与检索](./docs/cn/university/knowledge-base/index.md)  

  • [一人公司实战（一个人，一支团队）](./docs/cn/university/one-person-company/index.md)




  🔧 更多场景  

  • [安全防护清单](./docs/cn/university/security/index.md)  

  • [Agent 论文推送助手](./docs/cn/university/paper-assistant/index.md)  

  • [更多场景实战：智能家居控制助手](./docs/cn/university/smart-home-control/index.md)  

  • [更多场景实战：金融数据分析助手](./docs/cn/university/finance-research/index.md)  

  • [更多场景实战：教育培训辅助助手](./docs/cn/university/training-assistant/index.md)

第一部分：领养 Claw（使用篇，11 章 + 附录 A-G）

章节	简介	状态
写在开头	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（开发篇，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

📄 LICENSE

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

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

hello-claw