配置 — 智能体运行时和 CLI 后端

运行时策略决定由哪个 harness 执行一次模型运行。它定义在 provider 和 model 上，而不是 agents.defaults 上。

运行时策略¶

{
  models: {
    providers: {
      openai: {
        agentRuntime: { id: "codex" },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-6-astra",
      models: {
        "anthropic/claude-opus-5": {
          agentRuntime: { id: "claude-cli" },
        },
        "vllm/*": {
          agentRuntime: { id: "openclaw" },
        },
      },
    },
  },
}

• id："auto"、"openclaw"、已注册的插件 harness id，或受支持的 CLI 后端别名。内置的 Codex 插件注册了 codex；内置的 Anthropic 插件提供 claude-cli CLI 后端。
• id: "auto" 允许已注册的插件 harness 认领那些声明了支持契约或以其他方式满足该契约的有效路由；当没有 harness 匹配时，则使用 OpenClaw。显式指定插件运行时（如 id: "codex"）要求使用该 harness 和兼容的有效路由；如果任一者不可用或执行失败，则故障关闭（fail-closed）。
• id: "pi" 仅作为 openclaw 的已弃用别名被接受，以保留 v2026.5.22 及更早版本附带的配置。新配置应使用 openclaw。
• 运行时优先级依次为：精确模型策略（agents.entries.*.models["provider/model"]、agents.defaults.models["provider/model"] 或 models.providers.<provider>.models[]），然后是 agents.entries.* / agents.defaults.models["provider/*"]，最后是 provider 全局策略 models.providers.<provider>.agentRuntime。
• agent 级运行时键属于旧版遗留。agents.defaults.agentRuntime、agents.entries.*.agentRuntime、会话运行时固定设置以及 OPENCLAW_AGENT_RUNTIME 都会被运行时选择忽略。运行 openclaw doctor --fix 可移除过时值。
• 符合条件的、精确匹配的官方 HTTPS OpenAI Responses/ChatGPT 路由（未编写请求覆写）可以隐式使用 Codex harness。Provider/model 上的 agentRuntime.id: "codex" 将 Codex 设为故障关闭（fail-closed）要求，但不会让不兼容的路由变得兼容。
• 对于 Claude CLI 部署，建议采用 model: "anthropic/claude-opus-5-5" 并配合模型级 agentRuntime.id: "claude-cli"。旧版 claude-cli/<model> 引用出于兼容性仍可使用，但新配置应保持 provider/model 选择为规范形式，并将执行后端放入 provider/model 的运行时策略。
• 该设置控制文本 agent 回合和免工具的实用补全，包括会话摘要、进度播报和工具调用标题。媒体生成、视觉、PDF、音乐、视频和 TTS 仍使用各自的 provider/model 设置。

内置别名简写（仅在模型位于 agents.defaults.models 时生效）：

你配置的别名始终优先于默认值。

Z.AI GLM-4.x 模型会自动启用思考模式，除非你自己设置了 --thinking off，或自行定义了 agents.defaults.models["zai/<model>"].params.thinking。 Z.AI 模型默认会为工具调用流式输出启用 tool_stream。将 agents.defaults.models["zai/<model>"].params.tool_stream 设为 false 即可禁用。 Anthropic Claude Opus 4.8 在 OpenClaw 中默认保持思考关闭；当显式启用自适应思考时，Anthropic 的 provider 自有 effort 默认值为 high。Claude 4.6 模型在未设置显式思考级别时，默认使用 adaptive。

CLI 后端选择¶

CLI 适配器机制由插件注册，而不是在 agent 默认配置下配置。如上所示，使用模型级 agentRuntime.id 选择已注册的 CLI 后端。操作方法参见 CLI 后端，命令、会话、图像和解析器的注册参见 构建 CLI 后端插件。

OpenAI GPT-5 个性¶

内置的 OpenAI 插件负责 GPT-5 友好交互风格设置。匹配的 GPT-5 系列提示会获得共享行为契约；personality 仅控制友好风格层。原生 Codex app-server 路由保留 Codex 自有的基础/模型指令，而不是这份 OpenClaw GPT-5 贡献；并且对于原生线程，OpenClaw 会禁用 Codex 内置的个性。

{
  plugins: {
    entries: {
      openai: {
        config: {
          personality: "friendly", // friendly | on | off
        },
      },
    },
  },
}

• "friendly"（默认）和 "on" 会启用友好交互风格层。
• "off" 仅禁用友好层；带标记的 GPT-5 行为契约仍保持启用。

关于 provider 和原生 Codex 行为，请参阅 OpenAI GPT-5 提示贡献。