Reference 0003
Agent Runtime 学习资源包
把 HiClaw、OpenClaw、Hermes Agent、Claude Code 放在同一张学习地图里：先用官方资料建立事实，再用教程补实操，最后回到 HiClaw 理解多 runtime 编排。
1. 怎么用这份资源
这不是链接仓库，而是 runtime 拆解路线。每个资源都标注了要解决的问题，避免陷入泛泛看教程。
| 优先级 | 怎么读 | 判断标准 |
|---|---|---|
| 官方文档 / 官方 GitHub | 用于建立事实：架构、术语、安装路径、runtime contract、工具/技能模型。 | 能不能回答“它的边界在哪里”。 |
| 实操教程 / 视频 | 用于观察真实安装、配置、失败点和工作流。 | 能不能复现一个最小任务。 |
| 比较文章 / 社区讨论 | 只作为问题雷达，不能直接当结论。 | 是否给出可验证配置、版本和任务样本。 |
2. HiClaw 主线
| 资源 | 重点 | 学完要能回答 |
|---|---|---|
| HiClaw GitHub README | HiClaw 支持多 Worker runtime：OpenClaw、QwenPaw、Hermes 可以在同一个协作系统里共存。 | HiClaw 统一的是 agent harness，还是某一个 agent runtime？ |
| HiClaw architecture.md | Manager、Worker、Team、Human、controller、Matrix、Gateway、MinIO 的边界。 | 一个 Worker runtime 接入 HiClaw 时，哪些事由 runtime 做，哪些事由 harness 做？ |
| HiClaw: Unified Deployment for OpenClaw and Hermes Workflows | 把 OpenClaw 和 Hermes 放进同一部署/协作平台的视角。 | 为什么比较 runtime 时，部署、通信、权限和人工介入同样重要？ |
3. OpenClaw
| 资源 | 重点 | 用于拆解 |
|---|---|---|
| Getting started - OpenClaw Docs | 安装、onboarding、Gateway、auth、chat session 的最小路径。 | OpenClaw 的第一可运行闭环是什么。 |
| Agent runtime - OpenClaw Docs | OpenClaw embedded agent runtime、workspace、bootstrap files、session store。 | 一个 OpenClaw agent process 需要哪些本地状态。 |
| Agent runtimes - OpenClaw Docs | runtime 和 provider 是不同层：runtime 驱动模型循环，provider 只提供模型能力。 | 为什么 runtime 不是换个模型。 |
| Skills - OpenClaw Docs | 技能如何通过 `SKILL.md`、gating、allowlist、env/API key 注入进入 agent 上下文。 | OpenClaw 的 skill 和 HiClaw/Claude Code 的 skill 概念有哪些相似与不同。 |
| Context - OpenClaw Docs | 上下文由 system prompt、history、tool results、attachments、workspace files 等组成。 | OpenClaw 如何把工具、技能和历史压进模型输入。 |
| freeCodeCamp: Build and Secure a Personal AI Agent with OpenClaw | 实操教程，重点看安全配置和 agentic loop，不要只看安装命令。 | 一个自托管 agent 为什么必须先讨论权限和隔离。 |
4. Hermes Agent
| 资源 | 重点 | 用于拆解 |
|---|---|---|
| Hermes Agent official site | Hermes 的定位：open-source、self-improving、desktop/terminal、sandbox backends。 | Hermes 为什么不只是 coding CLI。 |
| Hermes Agent Documentation | 安装、quickstart、核心能力的官方入口。 | 最小可运行 Hermes 需要哪些配置。 |
| NousResearch/hermes-agent GitHub | 源码、issues、releases，适合观察真实 bug、运行环境和项目边界。 | Hermes 的成熟度和常见故障点在哪里。 |
| Hermes Learning Path | 按目标选择路径：CLI assistant、Telegram/Discord bot、automation、RL training 等。 | 不同使用场景对应哪些模块。 |
| Hermes AI Providers | OpenRouter、Nous Portal、Anthropic、OpenAI、本地模型等 provider 配置。 | Hermes 如何把 runtime 和模型供应商解耦。 |
| Hermes Built-in Tools Reference | 内置工具集合，适合拆 terminal、file、browser、vision 等能力边界。 | Hermes agent loop 实际能调用哪些工具。 |
| Hermes Agent Masterclass | 长教程，适合看 memory layers、多个隔离 agent、Telegram bot 等实操路线。 | 持久记忆和多角色 agent 如何影响工作流。 |
5. Claude Code
| 资源 | 重点 | 用于拆解 |
|---|---|---|
| anthropics/claude-code GitHub | Claude Code 的官方定位：终端里的 agentic coding tool。 | Claude Code 的产品边界：代码库理解、命令执行、git workflow。 |
| Claude Agent SDK overview | 把 Claude Code 的工具、agent loop、context management 作为 SDK 使用。 | Claude Code 从 CLI 产品变成可编程 agent runtime 时，暴露了什么能力。 |
| Claude Agent SDK Python GitHub | Python SDK、bundled CLI、query API、streaming examples。 | 如何从代码里驱动 Claude Code agent loop。 |
| Claude Code 101 | 官方课程：安装、日常 workflow、context management、CLAUDE.md、subagents、skills、MCP、hooks。 | 一个工程团队要把 Claude Code 用好，需要配置哪些长期上下文。 |
| Claude Code in Action | 官方课程，偏实际开发任务、上下文管理和扩展策略。 | Claude Code 的真实工作流如何组织。 |
| How Anthropic teams use Claude Code | 官方实践材料，重点看 CLAUDE.md、MCP、权限和团队工作流。 | 企业内部如何降低 agentic coding 的上下文和权限风险。 |
6. 联合理解框架
| 维度 | OpenClaw | Hermes Agent | Claude Code | HiClaw 视角 |
|---|---|---|---|---|
| 核心定位 | 自托管个人 assistant / Gateway。 | 持久化、自改进、多后端 agent。 | 终端里的 agentic coding tool / SDK。 | 多 runtime 协作和控制面。 |
| 最该拆的模块 | Gateway、skills、context、channels。 | memory、skills、tools、sandbox backends。 | CLAUDE.md、tools、MCP、hooks、Agent SDK。 | Manager、Worker、controller、Matrix、Gateway、MinIO。 |
| 主要风险 | 自托管权限、skills 注入、channel 暴露。 | 长期记忆污染、工具权限、后台任务边界。 | 仓库/命令权限、上下文漂移、自动化误操作。 | 把 runtime 隔离、权限、可见协作和生命周期管理上收。 |
| 学习问题 | 它如何把消息变成模型运行和工具调用？ | 它如何长期学习并保持执行环境隔离？ | 它如何把代码库上下文变成可控开发流程？ | 多个 runtime 如何在同一任务/房间内协作？ |
7. 视频和社区材料
| 资源 | 怎么用 | 注意 |
|---|---|---|
| Run Claude Code, OpenClaw & Hermes from One Meta-Agent | 主题和本 reference 高度相关，适合看三个 runtime 被同一 meta-agent 编排的演示。 | 视频结论要回到官方文档验证，不直接当事实来源。 |
| The Ultimate Beginner's Guide to OpenClaw | 适合看 OpenClaw 初学者安装、onboarding、skills、memory、automation 的完整路径。 | 版本变化快，命令以官方 docs 为准。 |
| Hermes Agent - Full Course & Setup Guide | 适合观察 Hermes setup 的实际操作和常见配置路径。 | 安装和 provider 配置以 Hermes 官方 docs 为准。 |
| Claude Code best practices | Anthropic 相关分享，适合补 Claude Code 工作流经验。 | 和最新文档对照使用。 |
| Reddit: Hermes Agent local setup notes | 看真实用户遇到的 context、local model、硬件和速度问题。 | 社区经验只能作为问题清单，不能作为权威结论。 |
8. 推荐学习顺序
- 先读 HiClaw README 和 architecture，确认 harness 与 runtime 的边界。
- 读 OpenClaw getting started、agent runtime、skills、context，理解 Gateway 型 runtime。
- 读 Hermes official docs、learning path、providers、tools，理解持久记忆和 sandbox 后端。
- 读 Claude Code 101、Agent SDK overview、Python SDK，理解 coding agent 的上下文和工具模型。
- 最后回到 HiClaw：把三者映射成不同 Worker runtime，问“如果它接入 HiClaw，需要暴露哪些 spec、状态和安全边界”。
下一节课建议：做 Session 03，把 OpenClaw、Hermes、Claude Code 按 runtime contract 拆成同一张对照表。