哈喽！龙虾 🙋♀️ Adopt from scratch and build your first claw 🦞 来领养你的第一只龙虾！
See the code
一个不起眼的仓库里，龙虾诞生了。
选一只，送它上学堂；或动手写一只不被定义的龙虾。
它的梦想，从第一天起就很大。
Hello Claw：领养你的 AI 龙虾助理，上龙虾大学学 Skills，从零构建属于你的智能助理
📌 在线阅读 | 还想学 Vibe Coding
https://datawhalechina.github.io/hello-claw
本项目是一个面向 OpenClaw 的完整学习教程，帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率，还是想深入理解其原理并构建自己的版本，本教程都能为你提供清晰的学习路径。
本项目包含三大核心模块：
谁适合学习：
学习建议：
/v1/models、/v1/embeddings）、Microsoft Teams 官方 SDK 集成（流式回复/欢迎卡片/消息编辑删除）、Skills 一键安装配方与 Control UI 状态过滤、Slack 富回复恢复、CLI --container 容器内执行、Discord LLM 自动线程命名、before_dispatch 插件钩子、沙箱媒体安全修复，教程全章节同步|
🌅 个人效率 • 邮箱助手实战（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 的可能性！
欢迎更多贡献者加入
扫描下方二维码关注公众号：Datawhale
哈喽！龙虾 🙋♀️ Adopt from scratch and build your first claw 🦞 来领养你的第一只龙虾！
See the code
一个不起眼的仓库里，龙虾诞生了。
选一只，送它上学堂；或动手写一只不被定义的龙虾。
它的梦想，从第一天起就很大。
Hello Claw：领养你的 AI 龙虾助理，上龙虾大学学 Skills，从零构建属于你的智能助理
📌 在线阅读 | 还想学 Vibe Coding
https://datawhalechina.github.io/hello-claw
本项目是一个面向 OpenClaw 的完整学习教程，帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率，还是想深入理解其原理并构建自己的版本，本教程都能为你提供清晰的学习路径。
本项目包含三大核心模块：
谁适合学习：
学习建议：
/v1/models、/v1/embeddings）、Microsoft Teams 官方 SDK 集成（流式回复/欢迎卡片/消息编辑删除）、Skills 一键安装配方与 Control UI 状态过滤、Slack 富回复恢复、CLI --container 容器内执行、Discord LLM 自动线程命名、before_dispatch 插件钩子、沙箱媒体安全修复，教程全章节同步|
🌅 个人效率 • 邮箱助手实战（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 的可能性！
欢迎更多贡献者加入
扫描下方二维码关注公众号：Datawhale