《Claude Code 工程化实战》第 27 爆款 Agent 的设计密码与工程范式

本讲摘要· 读爆款 Agent 的源码不是为了抄功能、而是为了反推它们做对了什么。本讲拆解 OpenClawStar 第 1、平台型与 HermesStar 第 2、工程型这两类代表性 Agent、提炼出 4 大共通设计密码Harness / Channel / Skills / SubAgent和 5 个可复用工程范式。学完本讲、你应该能用看 3 套源码、提炼 1 个范式、落地 1 个项目的方法、持续从爆款里吸取养分、而不是只会用 Claude Code 自带的命令。1. 什么是爆款 Agent三维度筛选标准爆款不等于下载量第一、而是有可学习价值的产品。本讲用三个维度筛选维度硬指标软指标为什么重要行业口碑GitHub star 5K被官方文档 / 大会引用说明被同行验证过架构代表性开源 代码可读作者愿意讲架构说明有可学的设计选择工程化深度有完整的 CI / 测试 / 文档有企业用户在生产用说明不是 demo 级玩具按这三个维度筛、本讲选 OpenClaw平台型、生态化、Hermes工程型、极致本地化做样本。两者刚好代表 Agent 产品的两个极端、合起来覆盖 80% 的设计选择。排名仓库Star 数本讲定位1OpenClaw⭐ 381K平台型代表、本讲重点拆解2Hermes Agent⭐ 205K工程型代表、本讲重点拆解3AutoGPT⭐ 185K早期范式参考4LangChain⭐ 140KLLM 框架参照5Claude Code⭐ 135K本课程主线6Browser-Use⭐ 101K浏览器 Agent 范式最终核查结果数据截至 2026-06-29OpenClaw 与 Hermes 正是当前 GitHub Star 排名前二的 Agent 项目、用它们做样本、就等于站在行业最高点反推设计密码。⚠️ 坑 1· 只看 star 数选型——很多高 star 仓库是 awesome-list 型、只是收集链接没有设计选择反过来、有些 star 不高但设计极精巧的项目反而更值得学。本讲选 OpenClaw 与 Hermes、不仅是 star 高、更因为它们刚好覆盖平台型 vs 工程型两个极端。2. OpenClaw 架构深读平台型 Agent 的 7 层骨架实战代码块 1 — OpenClaw 的 7 层模块结构。看仓库根目录能反推它的设计意图OpenClaw/ ├── 01-frontend/ # Web UI / TUI / IDE 插件 ├── 02-runtime/ # Agent 执行循环 ├── 03-tools/ # 工具层(Bash / Read / Edit / Grep ...) ├── 04-channels/ # 跨平台通道(Telegram / Slack / CLI) ├── 05-memory/ # 长期记忆 CLAUDE.md 解析 ├── 06-skills/ # Skills 注册中心 └── 07-deployment/ # 部署 / CI / Plugin 打包OpenClaw 走平台化路线——核心思想是 Agent 不只是一个 CLI、而是一个能挂任意前端、任意通道、任意 Skills 的中间层。这跟 Claude Code CLI 的定位不太一样Claude Code 是一个具体的产品OpenClaw 是一个 Agent 操作系统。它对我们最有启发的设计是04-channels同一个 Agent runtime、可以挂 Telegram bot / Slack app / Web chat / 桌面 GUI。用户从哪个通道发命令、Agent 都能响应。这种一次 runtime、多端可达是 2026 年 Agent 产品的标配。层职责对应本课程借鉴点frontendUI 渲染无直接对应Claude Code 自带 TUI想清楚前端要不要做runtimeAgent 循环第 23-24 讲 Agent SDK循环要可中断、可恢复tools工具注册第 20 讲 Tools 工具系统工具要可插拔channels通道协议无直接对应可借鉴一次 runtime、多端可达memory记忆系统第 3 讲 CLAUDE.md 记忆记忆分层short / long / projectskills技能注册第 10-16 讲 Skills 全系Skills 要可发现、可降级deployment部署打包第 25 讲 Plugins一个 Skill 一个独立 npm 包3. Hermes 范式配置即代码、Channel 协议、跨运行时Hermes 是工程派的代表——它不是做一个新 Agent、而是让现有 Agent 跑得更好。三个核心范式实战代码块 2 — 配置即代码Code as Config。Hermes 把所有配置都用代码描述、不用 YAML / JSON// hermes.config.ts import { defineConfig } from hermes/core; export default defineConfig({ agents: { default: { model: claude-sonnet-4-7, system: ./prompts/main.md, tools: [Bash, Read, Edit, Grep], skills: [./skills/lint-fast, ./skills/test-runner] }, reviewer: { model: claude-haiku-4-5, system: ./prompts/reviewer.md, tools: [Read, Grep], isolated: true // 独立上下文 } }, channels: { cli: { enabled: true }, telegram: { token: process.env.TELEGRAM_BOT_TOKEN, webhook: /api/telegram } }, hooks: { PreToolUse: ./hooks/pii-guard.ts } });这个范式的价值用 TypeScript 写配置、可以 import 别的模块、可以用类型检查、可以在配置里跑逻辑。对比 JSON / YAML 配置的纯数据路线、这是配置即代码——配置本身是项目里的一份源代码、可以被 lint、被 type-check、被测试。Channel 协议Hermes 定义了一个抽象的 Channel 接口、每个 ChannelCLI / Telegram / Web都实现这个接口。Agent 不关心消息从哪来、只管我收到了一条消息、要给出回复。这种输入适配器模式让 Agent 真正做到端无关。跨运行时Hermes 的 runtime 抽象可以挂在 Node.js、Bun、Deno、甚至浏览器 Web Worker。核心是把 system prompt tools message 变成一个标准化的 task、丢给任何能跑 LLM 的环境。⚠️ 坑 2· 抄配置即代码但用 JS 不用 TS——没有类型保护的配置、改一个字段名 runtime 才发现错了。配置代码必须上 TypeScript 严格模式。4. 4 大共通设计密码Harness / Channel / Skills / SubAgent通读两个项目的源码、能反推出 4 个共通的设计密码这 4 个密码不是 OpenClaw / Hermes 独有的、而是 2025-2026 年所有头部 Agent 产品的共识Claude Code、Gemini CLI、Cursor、Continue.dev、Cline 都在不同程度上实现了这 4 个。学完本课程、你已经掌握了 Claude Code 版本的全部 4 个、等于掌握了行业基准线。5. 5 个可复用工程范式从爆款反推范式除了 4 大密码、还有 5 个工程范式也是行业标配范式核心思想代表项目适用场景范式 1 · 插件热加载Skills / Plugins 运行时注册、无需重启Claude Code、OpenClaw频繁加新能力的产品范式 2 · 工具白盒化工具的 schema 显式声明、Agent 看得到Hermes、Claude Code需要 Agent 自主选工具范式 3 · 流式思考Agent 边想边吐 token、不要沉默 30 秒再回答Cursor、Claude Code所有交互式 Agent范式 4 · 错误可恢复工具调用失败时、Agent 能 retry 或 fallbackOpenClaw、Agent SDK长链路任务范式 5 · 审计可观测每次工具调用落日志、可回放Hermes、Claude Code Hooks企业 / 合规场景实战代码块 3 — 工具白盒化。Hermes 的工具 schema 范本// tools/read-file.ts import { z } from zod; import { defineTool } from hermes/core; export default defineTool({ name: Read, description: Read a file from the filesystem. Returns file content with line numbers., input: z.object({ file_path: z.string().describe(Absolute path to the file), offset: z.number().int().min(0).optional().describe(Line offset to start from), limit: z.number().int().min(1).max(2000).optional().describe(Max lines to read) }), output: z.object({ content: z.string(), total_lines: z.number().int(), truncated: z.boolean() }), risk: low, // 告诉 Agent 这个工具的危险等级 async execute({ file_path, offset 0, limit 2000 }) { // 实现 ... } });注意risk: low字段——这是把工具危险等级显式声明、Agent 在自主选工具时会参考。对比 Claude Code 的隐式风险只能靠 deny 规则拦、这是更显式的设计。⚠️ 坑 3· 抄工具白盒化但跳过 description——description 是 Agent 选工具的唯一依据、写读文件三个字远不如写读取文件内容、返回带行号的文本、适合查看代码或配置有用。6. 拿来主义在自己的项目里怎么抄作业学完 OpenClaw 与 Hermes 的范式之后、怎么把这些范式带回自己的项目推荐三步法实战代码块 4 — 抄作业 Checklist。每次读完一个爆款、过一遍这个清单# 爆款学习 Checklist ## 1. 它解决了什么问题? - [ ] 用户痛点是什么?为什么非它不可? - [ ] 替代品是什么?它比替代品好在哪? ## 2. 它的核心抽象是什么? - [ ] 用 1 句话总结它的主架构 - [ ] 这个抽象可以套到我的项目吗? ## 3. 它做对了哪 3 件事? - [ ] 列出最值得学的 3 个设计选择 - [ ] 每个选择为什么好?解决了什么具体问题? ## 4. 它做错了哪 1 件事? - [ ] 列出最明显的 1 个缺陷 - [ ] 我能不能避免这个缺陷? ## 5. 我能从中拿走什么? - [ ] 提炼 1 个可复用的范式(用 50 字内说清楚) - [ ] 列出在我的项目里落地的 3 个具体动作具体到本课程学完后、你已经能在 Claude Code 里直接用上这些范式Harness / Skills / SubAgent / Channel / Hooks / Plugins、所以抄作业的姿势应该是——**先在 Claude Code 里把范式用熟、再去读 OpenClaw / Hermes 源码验证哦原来人家也是这么做的、最后在 Agent SDK 上自己实现一遍。**下面给出 OpenClaw 与 Hermes 的源码深读路径、按推荐顺序读、配合上面的 Checklist、能最快抽干它们的精华。6.1 OpenClaw 源码深读指南OpenClawOpenClaw/openclaw是 GitHub Star 第 1 的 Agent 平台、读它不需要从头到尾看完、按这条路径走最快阅读顺序目录 / 文件看什么对应本讲哪一节①02-runtime/Agent 主循环怎么中断、怎么恢复第 23-24 讲②04-channels/同一个 runtime 如何挂 Telegram / Slack / Web第 2 节③03-tools/工具如何注册、如何插拔第 20 讲④05-memory/短期 / 长期 / 项目三级记忆怎么分层第 3 讲⑤06-skills/Skills 的发现机制与降级策略第 10-16 讲⑥07-deployment/一个 Skill 如何独立打包成 npm第 25 讲6.2 Hermes 源码深读指南HermesNousResearch/hermes-agent是 GitHub Star 第 2 的工程派 Agent、按这条路径读最出活阅读顺序文件 / 模块看什么对应本讲哪一节①hermes.config.ts配置即代码范式、TS 类型如何保护配置第 3 节 · 配置即代码②channels/interface.tsChannel 接口如何抽象输入适配器第 3 节 · Channel 协议③runtime/adapter.tsruntime 如何跨 Node / Bun / Deno / Web Worker第 3 节 · 跨运行时④tools/read-file.ts工具 schema 与risk字段如何白盒化第 5 节 · 范式 2 工具白盒化⑤hooks/pii-guard.tsPreToolUse 钩子如何做敏感信息拦截第 5 节 · 范式 5 审计可观测⑥agents/reviewer.ts独立上下文的 reviewer agent 如何调度第 4 节 · SubAgent 密码⚠️ 坑 4· 读源码不写笔记——3 个月后忘光。读完一个仓库、必须用 1 页纸总结它的主架构 3 个优点 1 个缺点、存进你自己的 knowledge base。7. 一句话备忘 读爆款源码、不是为了抄功能、而是为了反推它们做对了什么、再把范式带回自己的项目。 学习建议· 三个项目一起读、视角才能立体。建议按Claude Code → OpenClaw → Hermes的顺序交叉看① Claude Code是你的母语、先把 Harness / Skills / SubAgent / Hooks / Plugins 玩熟、建立体感② OpenClaw帮你跳出 CLI 视角、看一个真正的 Agent 平台怎么用 7 层骨架挂任意前端与通道、专攻系统架构③ Hermes帮你从工程派视角看范式——配置即代码、Channel 协议、跨运行时、工具白盒化、审计可观测——专攻工程落地。读完之后、回头看任何 AgentAutoGPT、LangChain、Browser-Use 等都能很快定位它在 4 大密码和 5 个范式上的取舍。