Agent 运行时类型

概述

Agent Runtime（运行时）是接收 prompt、驱动模型输出、处理工具调用并返回结果的组件。它与 Provider（认证/模型发现）和 Channel（消息渠道）是不同的层次。

核心要点

四层概念区分：

层次	示例	含义
Provider	openai, anthropic	认证方式与模型发现
Model	gpt-5.5, claude-opus-4-6	选用的具体模型
Agent Runtime	pi, codex, claude-cli	执行 turn 的底层循环
Channel	Telegram, Slack	消息进出的渠道

两类运行时家族：

• 嵌入式 Harness：在 OpenClaw 准备好的 Agent Loop 内运行，包括内置 pi 和插件注册的 codex
• CLI 后端：运行本地 CLI 进程，如 claude-cli、google-gemini-cli

Codex 相关的五个独立概念（常见混淆点）：

1. Native Codex app-server runtime → openai/* 模型引用
2. Codex OAuth auth profiles → openai-codex 认证提供商
3. Codex ACP adapter → runtime: "acp", agentId: "codex"
4. Native Codex chat-control → /codex ... 命令
5. OpenAI Platform API → openai/* + API key 认证

运行时选择优先级：

1. 模型级 runtime policy（agents.defaults.models["provider/model"].agentRuntime）
2. Provider 级 runtime policy（models.providers.<provider>.agentRuntime）
3. auto 模式下插件注册的运行时
4. 默认回退到 PI

重要规则：OpenAI agent 模型默认走 Codex harness；显式 PI 配置是兼容路由的 opt-in。

配置/使用

Claude CLI 后端配置（推荐写法）：

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

相关页面

• agent-loop — Agent 执行循环
• models — 模型选择与配置
• model-providers — Provider 路由与认证
• agent — Agent 运行时概述