エージェントランタイム

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​

Codex のサーフェス

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

1. ユーザーが Codex のバインド/制御/スレッド/再開/誘導/停止を求めている場合、バンドルされた codex Plugin が有効なら、ネイティブの /codex コマンドサーフェスを使用します。
2. ユーザーが 埋め込みランタイムとしての Codex を求めている場合、または通常のサブスクリプションに支えられた Codex エージェント体験を望んでいる場合は、openai/<model> を使用します。
3. ユーザーが OpenAI モデル用に PI を明示的に選択している場合、モデル参照は openai/<model> のままにし、プロバイダー/モデルのランタイムポリシーを agentRuntime.id: "pi" に設定します。選択された openai-codex 認証プロファイルは、PI のレガシー Codex 認証トランスポートを通じて内部的にルーティングされます。
4. レガシー設定にまだ openai-codex/* モデル参照が含まれている場合は、openclaw doctor --fix で openai/<model> に修復します。doctor は、古いモデル参照がそれを示していた箇所に、プロバイダー/モデルスコープの agentRuntime.id: "codex" を追加することで、Codex 認証ルートを維持します。
5. ユーザーが ACP、acpx、または Codex ACP アダプターと明示的に言っている場合は、runtime: "acp" と agentId: "codex" で ACP を使用します。
6. リクエストが Claude Code、Gemini CLI、OpenCode、Cursor、Droid、または別の外部ハーネスに関するものである場合は、ネイティブのサブエージェントランタイムではなく ACP/acpx を使用します。

​

ランタイムの所有権

• OpenClaw がサーフェスを所有する場合、OpenClaw は通常の Plugin フック動作を提供できます。
• ネイティブランタイムがサーフェスを所有する場合、OpenClaw にはランタイムイベントまたはネイティブフックが必要です。
• ネイティブランタイムが正規のスレッド状態を所有する場合、OpenClaw はサポートされていない内部を書き換えるのではなく、ミラーリングし、コンテキストを投影するべきです。

​

ランタイムの選択

1. モデルスコープのランタイムポリシーが優先されます。これは、設定済みのプロバイダーモデルエントリ、または agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime に置くことができます。
2. 次に、models.providers.<provider>.agentRuntime のプロバイダースコープのランタイムポリシーが続きます。
3. auto モードでは、登録済み Plugin ランタイムが、サポートされているプロバイダー/モデルの組み合わせを要求できます。
4. auto モードでターンを要求するランタイムがない場合、OpenClaw は互換ランタイムとして PI を使用します。実行を厳密にする必要がある場合は、明示的なランタイム ID を使用してください。

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

​

互換性契約

​

ステータスラベル

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

​

関連

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