hello-claw：一份围绕 OpenClaw 的中文教程仓库，值得谁花时间
哈喽！龙虾 🙋♀️ Adopt from scratch and build your first claw 🦞 来领养你的第一只龙虾！
秒懂
- 它是什么？
- datawhalechina/hello-claw 不是可安装的软件，而是一套面向 OpenClaw 命令行 AI 助理的中文学习材料，分使用、场景、开发三部分。判断要不要跟进，取决于你是否已经接受 OpenClaw 这个前提。
- 适合谁用？
- 已经决定用 OpenClaw、并且需要一个中文入口的人，可以从在线阅读站点按章节顺序读；只想评估 Agent 架构、不打算绑定某一个具体实现的开发者，先看第二部分「构建龙虾」的源码拆解章节，再决定是否投入时间。零基础用户不要跳过第 1 章 AutoClaw 桌面客户端那条路径，直接上手手动安装容易卡在 Node.js 与 onboard 向导。
- 能商用吗？
- 未经许可不能。GitHub 在这个仓库里没有找到许可证文件；没有许可证，默认即「保留所有权利」：你可以阅读代码，但不能复用。使用前请看看 README，或先征得作者同意。
- 还在维护吗？
- 在维护。仓库最近一次提交在 27 天前。
- 用什么语言写的？
- 主要是 JavaScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它教的不是 hello-claw，而是 OpenClaw
仓库名容易误导。hello-claw 里没有可运行的 claw 程序，README 把它定义为一个面向 OpenClaw 的完整学习教程，目标是让人从零掌握这套命令行 AI 助理系统。真正的软件是 OpenClaw，本仓库是围绕它的中文教学材料。
这个区分决定了它的使用方式。你不会 npm install hello-claw，而是照着教程去装 OpenClaw，再回来读下一章。仓库本身承担的是路径组织、术语翻译和场景示例三件事。对中文读者来说，第三件事的价值最大：OpenClaw 的文档和社区讨论以英文为主，把安装、模型配置、渠道接入这些环节用中文重讲一遍，能省掉不少查词时间。
目标读者在 README 里列了四类：零基础用户、想通过 QQ / 飞书 / Telegram 远程控制 AI 的效率用户、对技能系统感兴趣的技术爱好者、想理解 Agent 架构并自建版本的开发者。四类人对应三条不同的阅读路线，这一点后面单独说。
三部分结构：使用、场景、开发，各自独立
README 把内容分成三大模块，这个划分不是按难度递增，而是按目的分叉。
第一部分「领养龙虾」是使用篇，11 章加附录 A 到 G，内部又分成四组：安装（第 1 到 3 章）、核心配置（第 4 到 6 章）、扩展运维（第 7 到 9 章）、安全与客户端（第 10 到 11 章）。README 明确写了按需选读，也就是说这 11 章不要求顺序读完。安装组里第 1 章走 AutoClaw 桌面客户端，第 2 章走手动安装，包含终端介绍、Node.js 安装、npm install 和 onboard 配置向导。两条路径对应两类人，不是同一件事的简单版和复杂版。
第二部分「龙虾大学」是场景实战，按个人效率、编程开发、内容创作、商务销售、多智能体协作、更多场景六类组织，每类下列出具体案例文档。README 给的建议是按场景挑 5 到 10 个 Skills 快速落地。
第三部分「构建龙虾」是开发篇，11 章，先拆解 OpenClaw 源码与替代方案，再进入 Skills、渠道和完整定制。README 的更新记录显示，这一部分的核心架构解析章节覆盖提示词系统、工具系统、消息循环、多渠道接入四块。
场景篇才是这个仓库的差异点
安装和配置类教程的替代品不少，OpenClaw 官方文档本身就能覆盖。真正让 hello-claw 有辨识度的是第二部分。
它的组织方式接近选修课菜单：邮箱助手（163）、本地健康管理助手、早间简报自动化、智能日程管理、Vibe Coding 实战、CI/CD 助手、文档自动生成、自动化科研、内容创作工作室、客户支持与 CRM 协同、会议预约与纪要、多智能体协作（Multi OpenClaw / HiClaw）、知识库共享与检索、一人公司、安全防护清单、论文推送助手、智能家居控制、金融数据分析、教育培训辅助。每一篇是独立文档，路径在 docs/cn/university/ 下面。
这种菜单式结构的好处是不要求前置知识连贯，坏处是读者容易收集一堆 Skills 却拼不成工作流。README 里「按场景挑 5~10 个」这句话其实是在承认这个风险。另外，场景文档的质量取决于作者对那个场景的理解深度，金融数据分析和智能家居控制这类跨度很大的题目，单篇文档能覆盖的深度有限，读之前最好先看目录判断它讲的是流程还是只给了 Skills 清单。
安装路径与配置项：README 里能确认的部分
README 没有贴出完整的命令清单，但章节标题给出了可验证的线索。第 2 章的描述是「终端介绍、Node.js 安装、npm install、onboard 配置向导」，第 3 章是「CLI 向导、macOS 引导、Custom Provider、重新配置」。也就是说，OpenClaw 通过 npm 分发，首次配置走 onboard 命令，模型接入支持自定义 provider。
第 5 章模型管理提到 CLI 管理、多提供商配置、API Key 轮换、故障转移。第 7 章工具与定时任务提到定时任务的三种形态：cron、at、every，以及 Web 搜索。第 8 章网关运维涉及启动管理、热更新、认证安全、密钥管理、沙箱策略、日志监控。第 9 章远程访问涉及 SSH 隧道和 Tailscale 组网。
这些都是章节标题层面的信息，具体命令、配置键名和文件路径需要进对应章节看。本文不重复猜测这些细节。需要提醒的是，onboard 向导和 Custom Provider 这类交互式配置在不同版本间容易变动，照着教程敲之前先确认你装的 OpenClaw 版本号。
教程跟着上游跑，同步压力是真实成本
README 的最新动态部分列了一串带日期的更新，其中多条是 OpenClaw 上游发版后教程全章节同步。例如 2026-03-25 那条记录 OpenClaw v2026.3.24 带来 Gateway OpenAI 兼容端点（/v1/models、/v1/embeddings）、Microsoft Teams 官方 SDK 集成、Skills 一键安装配方、CLI --container 容器内执行、before_dispatch 插件钩子等改动，并注明教程全章节同步。2026-03-23 那条记录 OpenClaw 3.22 的插件 SDK 重构，旧 extension-api 废弃。
这带来两个后果。第一，教程的时效性绑定在上游节奏上，上游改接口，教程里对应的部分就会过期，而仓库的同步是人工完成的，存在滞后窗口。第二，如果你读的是较早的快照，可能学到已经废弃的 API，插件 SDK 重构那一条就是例子。
对维护者来说这是持续投入，对读者来说这意味着阅读时需要留意章节对应的版本。仓库没有 releases，所以没有版本化的教程快照可用，只能以在线阅读站点的当前内容为准。
许可证这件事，README 自身就有矛盾
README 顶部的徽章标注 License-CC_BY_NC_SA_4.0，链接指向仓库的 LICENSE 文件。但仓库元数据里许可证字段为 unknown，没有检索到 release。
CC BY-NC-SA 4.0 的含义是非商业性使用、相同方式共享、署名。对个人学习没有影响，对想把教程内容搬进内部培训材料或商业产品的团队，NC 这一条需要认真看。SA 条款还要求衍生作品采用相同许可证。
这里不是法律意见，只是指出一个操作层面的问题：徽章和元数据不一致，采用前应该打开仓库根目录的 LICENSE 文件自己读一遍，确认它和徽章声明的是同一份协议。如果计划把内容整合进自己的文档体系，这个确认步骤不能省。
什么时候它不合适：三个具体场景
第一，你还没决定用哪个 Agent 框架。hello-claw 全篇以 OpenClaw 为对象，第 2 章教你装它，第 4 章教你把飞书接进去，第 8 章讲它的网关。如果你还在比较不同实现，这份教程帮不上忙，它不做横向对比，第三部分虽然提到「替代方案探索」，但那是站在已经选了 OpenClaw 的位置上回看。
第二，你需要英文或非中文的团队文档。仓库有 README_EN.md 和 README_JA.md，但正文文档路径是 docs/cn/，主体内容是中文。多语言团队需要自己处理翻译。
第三，你只想快速跑通一个自动化。教程的完整路径是 11 章加附录，即使按需选读，安装加核心配置也占了 6 章。如果目标只是接一个聊天渠道加一个定时任务，直接看 OpenClaw 官方文档可能更快，教程的价值在于系统性和中文表达，不在于短。
另外，README 的更新记录里提到过若干安全修复，包括 SMB 凭证泄露、环境变量注入、Unicode 伪装、沙箱媒体安全。这说明 OpenClaw 的攻击面不小，第 10 章专门讲威胁模型和 VM 隔离是有原因的。对安全敏感的环境，教程能提供清单，但隔离方案要自己落地。
和同类中文教程的差别在哪
中文社区里教人搭 AI 助理的材料，多数是单篇博客或视频，讲清楚一个渠道怎么接、一个模型怎么配就结束了。hello-claw 的结构不一样：它把安装、配置、运维、安全、客户端拆成 11 章，再叠一层场景实战，最后加一层源码拆解。
差别主要落在第三部分。多数教程止步于「怎么用」，hello-claw 花 11 章讲「怎么造」，README 记录的内容包括提示词系统、工具系统、消息循环、多渠道接入，以及 Skill 的文件结构、Frontmatter、异步处理与调试。这部分对想自建 Agent 的开发者有实际参考价值，因为它把 OpenClaw 的实现拆开给你看，而不是只给 API 文档。
代价是深度换广度。每一章能覆盖的内容有限，源码解析类章节通常需要读者自己去读配套代码才能吃透。把它当索引和路线图用，比当权威参考手册用更合适。
编辑结论
已经决定用 OpenClaw、并且需要一个中文入口的人，可以从在线阅读站点按章节顺序读；只想评估 Agent 架构、不打算绑定某一个具体实现的开发者，先看第二部分「构建龙虾」的源码拆解章节，再决定是否投入时间。零基础用户不要跳过第 1 章 AutoClaw 桌面客户端那条路径，直接上手手动安装容易卡在 Node.js 与 onboard 向导。采用前需要自己确认两件事：仓库根目录的 LICENSE 文件与 README 徽章标注的 CC BY-NC-SA 4.0 是否一致，以及 OpenClaw 上游版本迭代是否已经超过教程同步的章节范围，因为教程的更新记录与上游发版是两条独立的时间线。
社区笔记