hello-claw

## 在线阅读 https://datawhalechina.github.io/hello-claw ## 项目简介 本项目是一个面向 OpenClaw 的完整学习教程，帮助你从零开始掌握这个强大的命令行 AI 助理系统。无论你是想快速上手使用 OpenClaw 提升效率，还是想深入理解其原理并构建自己的版本，本教程都能为你提供清晰的学习路径。 **本项目包含三大核心模块：** 1. **领养龙虾（使用篇）**：11 章 + 7 个附录，安装（Ch1-3）+ 核心配置（Ch4-6）+ 扩展运维（Ch7-9）+ 安全与客户端（Ch10-11），按需选读 2. **龙虾大学（场景实战篇）**：围绕 Skills 选型与典型工作流，给出可直接复用的实战案例 3. **构建龙虾（开发篇）**：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 论文推送助手
• 更多场景实战：智能家居控制助手
• 更多场景实战：金融数据分析助手
• 更多场景实战：教育培训辅助助手 ### 第一部分：领养 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 的可能性！ ## 贡献者名单 | 姓名 | 职责 | | :-------------------------------------- | :--------- | | [桂子轩](https://github.com/zixuangui-rgb) | 核心贡献者 | | [赵志民](https://github.com/zhimin-z) | 核心贡献者 | | [李秀奇](https://github.com/li-xiu-qi) | 核心贡献者 | | [刘丽欣](https://github.com/liulx25xx) | 核心贡献者 | | [刘思怡](https://github.com/liusiyi77m) | 核心贡献者 | | [散步](https://github.com/sanbuphy) | 核心贡献者 | *欢迎更多贡献者加入* ## 参与贡献 - 如果你发现了一些问题，可以提 Issue 进行反馈，如果提完没有人回复你可以联系[保姆团队](https://github.com/datawhalechina/DOPMC/blob/main/OP.md)的同学进行反馈跟进 - 如果你想参与贡献本项目，可以提 Pull Request，如果提完没有人回复你可以联系[保姆团队](https://github.com/datawhalechina/DOPMC/blob/main/OP.md)的同学进行反馈跟进 - 如果你对 Datawhale 很感兴趣并想要发起一个新的项目，请按照 [Datawhale 开源项目指南](https://github.com/datawhalechina/DOPMC/blob/main/GUIDE.md)进行操作即可 ## 关注我们 ## LICENSE --- ## ⭐ Star History