代理harness选择政策

OpenClaw 在提供程序和模型解析后如何选择harness、故障对模型后备链的影响以及为什么harness通常与提供程序插件一起提供。 Agent harness插件 参考的一部分。

选择策略

OpenClaw 会在 provider/model 解析之后选择 harness：

1. Model 范围的运行时策略优先。
2. Provider 范围的运行时策略其次。
3. auto 询问已注册的harness是否支持已解析的有效路线。 Provider/model 前缀永远不会单独选择harness。
4. 如果没有已注册的 harness 匹配，OpenClaw 会使用其内嵌运行时。

对于已配置的模型，传输详细信息和请求覆盖来自同一选定模型行。精确模型 ID 优先于旧的提供程序前缀行，包括当精确行继承提供程序默认值时。

插件harness故障表现为运行故障。在 auto 模式下，嵌入式回退仅在没有注册的插件harness支持解析的 provider/model. 时适用。一旦插件harness声明运行，OpenClaw 不会通过另一个运行时重播同一回合，因为这可能会更改 auth/runtime 语义或重复的副作用。

harness开始任何模型工作之前发生的故障可能会使用 openclaw/plugin-sdk/agent-harness-runtime 中的 AgentHarnessPreflightError。对于整个模型后备链，默认错误仍然是终端。仅当故障发生在所选harness本地时才通过 { scope: "harness" }，并且在同一harness上重试另一个模型会重复该问题。 OpenClaw 在尝试边界记录实际选择的工具，仅跳过被证明使用该工具的后来候选者，并通过其正常运行时和策略检查运行任何不同拥有的候选者。插件选择加入范围，但永远不会在错误上指定harness所有者。在请求或工具操作可能产生副作用后，请勿使用harness范围。

配置的运行时策略对于所需的运行时仍然具有权威性。耐用的原生harness别针可保留其转录本所有者；即使模型选择被锁定，在插件拥有的具体模型聊天中观察到的harness也不会成为 pin。对于具体模型执行，请求和引脚都不会使不兼容的路由兼容：harness必须支持准备好的事实，声明确切的请求 OpenClaw 回退，或者拒绝运行。 绑定本机会话所有权单独标识其经过验证的本机连接拥有模型和身份验证的会话，因此不相关的外部路由元数据不会替换该连接。

下一回合元数据使用注册的支持决策并保留其 model/provider/session 源。历史生产者观察并不能确定下一个回合。投影从不加载harness或读取凭证。准备状态是明确的：丢失的 runtimePolicy 保持未声明状态，而不是从碰巧存在的任何传输字段中推断出来。当harness拥有的身份验证留下多个未解析的物理路由时，准备好的支持事实是它们兼容的运行时id和报告请求覆盖的交集（如果任何候选者拥有它们）。因此，一个未声明的候选者使本机兼容性成为空； preparedAuth.source: "harness" 是身份验证所有者，没有推断路由支持的权限。

如果所选工具令人惊讶，请启用 agents/harness 调试日志记录并检查网关的结构化 agent harness selected 记录：它包括所选工具 ID、选择原因、runtime/fallback 策略，以及在 auto 模式下每个候选插件的支持结果。

捆绑的 Codex 插件将 codex 注册为其harness ID。 Core 将其视为普通的插件harness ID； Codex-特定别名属于插件或操作员配置，而不是共享运行时选择器。

provider 与 harness 配对

大多数 harness 还应同时注册一个 provider。provider 会将模型引用、认证状态、模型元数据以及 /model 选择暴露给 OpenClaw 的其他部分。随后 harness 通过 supports(...) 声明对该 provider 的认领。

捆绑的 Codex 插件遵循此模式：

• 首选用户模型参考：openai/gpt-6-astra
• 兼容性 refs: 旧的 codex/gpt-* refs 仍然被接受，但新的配置不应再将它们用作常规 provider/model refs
• harness ID：codex
• auth：针对具体请求准备了OpenAI route/profile策略；已验证的本机身份验证绑定使用其本机连接
• app-server 请求: OpenClaw 将裸模型 id 发送给 Codex，并让 harness 与原生 app-server 协议交互

Codex 插件是附加的。在未设置运行时策略或 auto 的情况下，仅当其提供商拥有的路由合约声明 codex 兼容时，OpenAI 才可以选择 Codex：确切的官方 HTTPS 平台响应或 ChatGPT 响应路由，没有编写的请求覆盖。仅 openai/* 前缀永远不会选择 Codex。自定义端点、完成适配器和编写的请求行为保留在 OpenClaw 上。明文官方 HTTP 端点被拒绝。较旧的 codex/gpt-* 参考仍然是兼容性输入。请参阅 OpenAI 隐式代理运行时。

有关操作员设置、模型前缀示例和 Codex-only 配置，请参阅 Codex Harness。

Codex 插件强制执行 Codex Harness 中记录的最低应用程序服务器版本。它检查初始化握手并阻止旧的、格式错误的或未版本控制的服务器。许可允许启动继续进行；它并不能证明以后的运行时或功能操作会成功。