Agent ランタイム

• 埋め込みハーネスは、OpenClaw の準備済みエージェントループ内で実行されます。 組み込みの openclaw ランタイムに加えて、codex や copilot などの 登録済み Plugin ハーネスが含まれます。
• CLI バックエンドは、モデル参照を正規のまま保ちながらローカル CLI プロセスを実行します。 たとえば、モデルスコープの agentRuntime.id: "claude-cli" を伴う anthropic/claude-opus-4-8 は、「Anthropic モデルを選択し、Claude CLI 経由で実行する」 ことを意味します。claude-cli は埋め込みハーネス ID ではなく、AgentHarness の選択に 渡してはいけません。

​

Codex サーフェス

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

1. Codex の bind/control/thread/resume/steer/stop -> バンドルされた codex Plugin が有効な場合は、ネイティブの /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> に修復します。古いモデル参照がそれを示唆していた場合、doctor はプロバイダー/モデルスコープの agentRuntime.id: "codex" を追加して 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.list[].models["provider/model"].agentRuntime にあります。 agents.defaults.models["vllm/*"].agentRuntime のようなプロバイダーワイルドカードは、 正確なモデルポリシーの後に適用されるため、動的に検出されたプロバイダーモデルは、 正確なモデルごとの例外を上書きせずに 1 つのランタイムを共有できます。
2. プロバイダースコープのランタイムポリシー: models.providers.<provider>.agentRuntime。
3. auto モード: 登録済み Plugin ランタイムは、サポートするプロバイダー/モデルのペアを要求できます。
4. auto モードでターンを要求するものが何もない場合、OpenClaw は互換ランタイムとして openclaw にフォールバックします。実行を厳密にする必要がある場合は、明示的なランタイム ID を使用してください。

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

​

GitHub Copilot エージェントランタイム

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

​

互換性コントラクト

​

ステータスラベル

• openai/gpt-5.5 のようなモデル参照は、選択されたプロバイダー/モデルです。
• codex のようなランタイム ID は、ターンを実行しているループです。
• Telegram や Discord のようなチャンネルラベルは、会話が行われている場所です。

​

関連

• Codex ハーネス
• Codex ハーネスランタイム
• GitHub Copilot エージェントランタイム
• OpenAI
• エージェントハーネス Plugin
• エージェントループ
• モデル
• ステータス