Agent Harness
Agent harness 是 OpenClaw 单次准备好的 agent 轮次的底层执行器。它不是模型提供方，不是渠道，也不是工具注册表。面向用户的思维模型，请参阅 Agent 运行时。
仅将此接口用于随附或受信任的原生插件。该契约仍然是实验性的，因为参数类型有意镜像当前嵌入式 runner。核心专用的辅助运行控制不在此列：Side chat 的直接工具和所选会话读取限制属于内部行为，并非受支持的插件 harness 输入。
何时使用 harness¶
当某个模型系列拥有自己的原生会话运行时，而常规 OpenClaw provider 传输又是不正确的抽象时，请注册一个 agent harness：
- 一个原生编码 agent 服务器，负责管理线程与压缩（compaction）
- 一个必须流式传输原生 plan/reasoning/tool 事件的本地 CLI 或守护进程
- 一个除了 OpenClaw 会话记录外还需要自身 resume id 的模型运行时
不要仅仅为了添加新的 LLM API 而注册 harness。对于常规 HTTP 或 WebSocket 模型 API，请构建一个 provider 插件。
各部分位置变更¶
单页版本中的每个部分现在都位于本页或下面的八个子页面之一。来自单页版本的锚点仍然可以在此处解析。
核心所有权契约¶
Agent harness 核心所有权 — 核心在 runAttempt 之前准备的内容，以及 harness 可声明的工具策略、认证引导、会话所有权和请求传输契约。
Harness 注册¶
注册 Agent harness — AgentHarnessV2 注册示例，以及可选的隔离完成与委托执行能力。
Harness 选择与提供方配对¶
Agent harness 选择策略 — OpenClaw 在 provider 和模型解析完成后如何选择 harness，以及为什么 harness 通常随 provider 插件一起提供。
尝试运行时的辅助工具¶
Agent harness 尝试运行时 — 受保护的输入注入、工具结果中间件、终态结果分类、实时 token 使用量以及 Agent 端副作用。
用户输入与执行授权¶
Agent harness 用户输入与执行授权 — 阻塞式用户输入界面、主机工具能力、exec 审查者结果以及配对设备命令授权。
原生清单¶
Agent harness 原生清单 — 只读的原生模型行以及从 harness 自身运行时报告的 MCP 工具目录。
运行时配置¶
Agent harness 运行时配置 — 原生 Codex harness 模式，以及严格的 provider、模型或按 Agent 的运行时策略。
会话与结果¶
Agent harness 会话与结果 — 原生会话绑定和转录镜像，以及工具、媒体、终端结果和已结算轮次结果。
当前限制¶
- 公共导入路径是通用的，但某些 attempt/result 类型别名仍保留旧名称以兼容。
- 第三方 harness 安装为实验性功能。在需要原生会话运行时之前，请优先使用提供商插件。
- 支持跨轮次切换 harness。在原生工具、审批、助手文本或消息发送开始后，不要在同一轮次中途切换 harness。
相关¶
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw