Reference 0001
Agent Harness 术语速查
用 HiClaw 拆解 agent harness 时，先把词对齐。后续课程会沿用这些定义。
| 术语 | 在 HiClaw 里的含义 | 判断问题 |
|---|---|---|
| Agent app | 面向某个任务的应用，通常把 prompt、工具和 UI 绑在一起。 | 它是否只解决一个业务场景？ |
| Agent runtime | 实际执行 agent loop 的环境。HiClaw 支持 OpenClaw、QwenPaw、Hermes 等 Worker runtime。 | 它是否负责思考、调用工具、产出结果？ |
| Agent harness | 包住 runtime 的运行底座，负责创建、调度、隔离、通信、存储、凭据、安全和人工干预。 | 它是否让多个 agent 可治理地协作？ |
| Manager | 协调者 agent，负责拆任务、创建或调用 Workers、管理 Teams，并通过 Matrix 和 controller 交互。 | 谁决定任务给哪个 Worker？ |
| Worker | 执行者 agent，通常一个 Worker 对应一个容器或 Pod，执行具体任务。 | 谁真正做代码、浏览器、文件或工具操作？ |
| Controller | 控制平面，管理 Worker、Manager、Team、Human 资源，并负责生命周期和基础设施协调。 | 谁把声明变成实际容器或 Pod？ |
| Matrix room | Human、Manager、Worker 共享的可见协作通道，也是 human-in-the-loop 的载体。 | 人在哪里看见和打断 agent？ |
| Higress | AI Gateway / API Gateway，集中处理 LLM、MCP 和凭据隔离。 | 真实 API key 放在哪里？ |
| MinIO | 共享对象存储，用于 Manager 和 Workers 之间同步工作区、任务文件和产物。 | 大文件和中间产物放在哪里？ |
| Skill | 给 agent 读的可复用能力说明，通常是 SKILL.md 加 scripts 和 references。 | 这个能力是 prompt 指令、脚本，还是外部服务？ |
主要来源：HiClaw README 与 architecture.md。