Agent Runtimes

• 嵌入式执行框架在 OpenClaw 已准备好的智能体循环内运行：包括 内置 openclaw 运行时，以及已注册的插件执行框架，例如 codex 和 copilot。
• CLI 后端运行本地 CLI 进程，同时保持模型引用 规范。例如，anthropic/claude-opus-5 搭配模型范围的 agentRuntime.id: "claude-cli" 表示“选择 Anthropic 模型，通过 Claude CLI 执行”。claude-cli 不是嵌入式执行框架 ID，不得 传递给 AgentHarness 选择逻辑。

​

Codex 相关界面

{
  agents: {
    defaults: {
      model: "openai/gpt-5.6-sol",
    },
  },
}

1. Codex 绑定/控制/线程/恢复/引导/停止 -> 启用内置 codex 插件时，使用原生 /codex 命令界面。
2. 将 Codex 用作嵌入式运行时或使用常规的订阅支持型 Codex 智能体体验 -> openai/<model>。
3. 为 OpenAI 模型显式选择 OpenClaw -> 保持模型引用为 openai/<model>，并将提供商/模型运行时策略设置为 agentRuntime.id: "openclaw"。所选的 openai OAuth 配置文件会在内部通过 OpenClaw 的 Codex 身份验证传输层进行路由。
4. 配置中的旧版 Codex 模型引用 -> 使用 openclaw doctor --fix 将其修复为 openai/<model>；如果旧模型引用隐含使用 Codex 身份验证路由，Doctor 会添加提供商/模型范围的 agentRuntime.id: "codex"，从而保留该路由。旧版 codex-cli/* 模型引用会修复为相同的 openai/<model> Codex app-server 路由；OpenClaw 不再保留内置 Codex CLI 后端。
5. 明确要求 ACP、acpx 或 Codex ACP 适配器 -> runtime: "acp" 和 agentId: "codex"。
6. Claude Code、Gemini CLI、OpenCode、Cursor、Droid 或其他外部执行框架 -> 使用 ACP/acpx，而不是原生子智能体运行时。

​

运行时所有权

​

运行时选择

1. 模型范围的运行时策略优先。它位于已配置的提供商 模型条目中，或位于 agents.defaults.models["provider/model"].agentRuntime / agents.entries.*.models["provider/model"].agentRuntime 中。agents.defaults.models["vllm/*"].agentRuntime 之类的提供商 通配符在精确模型策略之后应用，因此动态发现的提供商模型可以 共享同一运行时，而不会覆盖针对具体模型的例外配置。
2. 提供商范围的运行时策略：models.providers.<provider>.agentRuntime。
3. auto 模式：已注册的插件运行时可以声明支持的提供商/模型组合。
4. 如果在 auto 模式下没有任何运行时接管该轮次，OpenClaw 会回退到 openclaw 作为兼容运行时。如果运行必须严格匹配， 请使用显式运行时 ID。

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-5",
      models: {
        "anthropic/claude-opus-5": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

GitHub Copilot agent runtime

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

​

兼容性契约

​

状态标签

• 诸如 openai/gpt-5.6-sol 的模型引用表示所选的提供商/模型。
• 诸如 codex 的运行时 ID 表示执行该轮次的循环。
• 诸如 Telegram 或 Discord 的渠道标签表示对话发生的位置。

​

相关内容

• Codex harness
• Codex harness runtime
• GitHub Copilot agent runtime
• OpenAI
• Agent harness plugins
• Agent loop
• Models
• 状态