OpenAI

OpenAI は GPT モデル向けの開発者 API を提供しており、Codex は OpenAI の Codex クライアントを通じて ChatGPT プランのコーディングエージェントとしても利用できます。OpenClaw は、両方の認証形式に対して 1 つのプロバイダー ID openai を使用します。

OpenClaw は、正規の OpenAI モデルルートとして openai/* を使用します。OpenAI モデルでの埋め込みエージェントターンは、デフォルトでネイティブ Codex アプリサーバーランタイムを通じて実行されます。直接の OpenAI API キー認証は、画像、埋め込み、音声、リアルタイムなど、非エージェント OpenAI サーフェスで引き続き利用できます。

• エージェントモデル - Codex ランタイム経由の openai/* モデル。ChatGPT/Codex サブスクリプション利用では Codex 認証でサインインします。または、API キー認証を意図的に使いたい場合は、Codex 互換の OpenAI API キーバックアップを構成します。
• 非エージェント OpenAI API - OPENAI_API_KEY または OpenAI API キーのオンボーディングを通じて、従量課金の直接 OpenAI Platform アクセスを使用します。
• レガシー設定 - レガシー Codex モデル参照は、openclaw doctor --fix により openai/* と Codex ランタイムへ修復されます。

OpenAI は、OpenClaw のような外部ツールやワークフローでのサブスクリプション OAuth 利用を明示的にサポートしています。

プロバイダー、モデル、ランタイム、チャネルは別々のレイヤーです。これらのラベルが混同されている場合は、設定を変更する前に エージェントランタイム を読んでください。

クイック選択

命名マップ

名前は似ていますが、互換性はありません。

つまり、設定には意図的に openai/* モデル参照を含めつつ、認証プロファイルは API キー資格情報または ChatGPT/Codex OAuth 資格情報のどちらかを指すことができます。設定には auth.order.openai を使用します。openclaw doctor --fix は、レガシー Codex モデル参照、レガシー Codex 認証プロファイル ID、レガシー Codex 認証順序を正規の OpenAI ルートへ書き換えます。

GPT-5.6 限定プレビュー

OpenClaw は、3 つの公開 GPT-5.6 モデル ID を認識します。

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

3 つすべてが、現在の Codex アプリサーバーカタログで max 推論を公開しています。OpenAI のローンチ発表では、Sol はフラッグシップティア、Terra はバランス型ティア、Luna は高速で低コストのティアとして説明されています。GPT-5.6 ローンチ発表 と プレビューアクセスガイド を参照してください。

プレビュー期間中のアクセスは許可リスト制で、API と Codex に対して別々に付与される場合があります。有料 ChatGPT プランだけではアクセスは付与されません。OpenClaw は openai/gpt-5.5 をデフォルトのままにします。アクセスなしで GPT-5.6 参照を選択した場合、暗黙にフォールバックするのではなく、上流のアクセスエラーを返します。

OpenClaw 機能カバレッジ

メモリ埋め込み

OpenClaw は、memory_search のインデックス作成とクエリ埋め込みに、OpenAI または OpenAI 互換の埋め込みエンドポイントを使用できます。

{  agents: {    defaults: {      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",      },    },  },}

非対称埋め込みラベルが必要な OpenAI 互換エンドポイントでは、memorySearch の下に queryInputType と documentInputType を設定します。OpenClaw は、それらをプロバイダー固有の input_type リクエストフィールドとして転送します。クエリ埋め込みは queryInputType を使用し、インデックス化されたメモリチャンクとバッチインデックス作成は documentInputType を使用します。完全な例については、メモリ設定リファレンス を参照してください。

はじめに

好みの認証方法を選び、セットアップ手順に従ってください。

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.5

openclaw models list --provider openai

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

ネイティブ Codex app-server 認証

ネイティブ Codex app-server ハーネスは、openai/* モデル参照に加えて、ランタイム設定の省略 または provider/model agentRuntime.id: "codex" を使用しますが、その認証は 引き続きアカウントベースです。OpenClaw は次の順序で認証を選択します。

1. エージェント向けの順序付けされた OpenAI 認証プロファイル。できれば auth.order.openai の下に置きます。古い レガシー Codex 認証プロファイル ID とレガシー Codex 認証順序を移行するには、openclaw doctor --fix を実行します。
2. app-server の既存アカウント。たとえばローカル Codex CLI ChatGPT サインイン。
3. ローカル stdio app-server 起動の場合のみ、app-server がアカウントなしと報告し、なお OpenAI 認証を必要とするときに、 CODEX_API_KEY、次に OPENAI_API_KEY。

つまり、Gateway プロセスが直接 OpenAI モデルや埋め込み向けに OPENAI_API_KEY も持っているというだけで、 ローカル ChatGPT/Codex サブスクリプションサインインが置き換えられることはありません。 環境 APIキーフォールバックはローカル stdio のアカウントなしパスだけです。 WebSocket app-server 接続には送信されません。サブスクリプション形式の Codex プロファイルが選択されると、OpenClaw は生成される stdio app-server 子プロセスから CODEX_API_KEY と OPENAI_API_KEY も除外し、選択された認証情報を app-server login RPC 経由で送信します。そのサブスクリプションプロファイルが Codex 使用量上限によってブロックされている場合、OpenClaw は選択中のモデルを変更したり Codex ハーネスから外れたりせずに、次に順序付けされた openai:* APIキープロファイルへローテーションできます。 サブスクリプションのリセット時刻が過ぎると、そのサブスクリプションプロファイルは 再び候補になります。

画像生成

バンドルされた openai Plugin は、image_generate ツールを通じて画像生成を登録します。 同じ openai/gpt-image-2 モデル参照を通じて、OpenAI APIキー画像生成と Codex OAuth 画像 生成の両方をサポートします。

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 は、OpenAI のテキストから画像生成と画像編集の両方のデフォルトです。gpt-image-1.5、gpt-image-1、gpt-image-1-mini は、明示的なモデル上書きとして引き続き使用できます。透明背景の PNG/WebP 出力には openai/gpt-image-1.5 を使用してください。現在の gpt-image-2 API は background: "transparent" を拒否します。

透明背景のリクエストでは、エージェントは model: "openai/gpt-image-1.5"、outputFormat: "png" または "webp"、および background: "transparent" を指定して image_generate を呼び出す必要があります。古い openai.background プロバイダーオプションも引き続き受け付けられます。OpenClaw は、デフォルトの openai/gpt-image-2 透明リクエストを gpt-image-1.5 に書き換えることで、公開 OpenAI ルートと OpenAI Codex OAuth ルートも保護します。Azure とカスタムの OpenAI 互換エンドポイントは、構成済みのデプロイメント名/モデル名を維持します。

同じ設定は、ヘッドレス CLI 実行にも公開されています。

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "A simple red circle sticker on a transparent background" \  --json

入力ファイルから開始する場合は、openclaw infer image edit で同じ --output-format フラグと --background フラグを使用します。--openai-background は、OpenAI 固有のエイリアスとして引き続き利用できます。OpenAI Images の品質とコストを制御する必要がある場合は、--quality low|medium|high|auto を使用します。image generate または image edit から OpenAI のプロバイダー固有のモデレーションヒントを渡すには、--openai-moderation low|auto を使用します。

ChatGPT/Codex OAuth インストールでは、同じ openai/gpt-image-2 参照を維持します。openai OAuth プロファイルが構成されている場合、OpenClaw は保存された OAuth アクセストークンを解決し、Codex Responses バックエンド経由で画像リクエストを送信します。そのリクエストでは、先に OPENAI_API_KEY を試したり、API キーへ暗黙的にフォールバックしたりしません。直接の OpenAI Images API ルートを使用したい場合は、API キー、カスタムベース URL、または Azure エンドポイントを使用して models.providers.openai を明示的に構成してください。 そのカスタム画像エンドポイントが信頼済み LAN/プライベートアドレス上にある場合は、browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true も設定してください。OpenClaw は、このオプトインが存在しない限り、プライベート/内部の OpenAI 互換画像エンドポイントをブロックしたままにします。

生成:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

透明 PNG を生成:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

編集:

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

動画生成

バンドルされた openai Plugin は、video_generate ツール経由で動画生成を登録します。

OpenAI の画像から動画リクエストは、画像 input_reference とともに POST /v1/videos を使用します。単一動画編集は、アップロードされた動画を video フィールドに入れて POST /v1/videos/edits を使用します。

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

GPT-5 プロンプト寄与

OpenClaw は、OpenClaw が組み立てたプロンプト面での GPT-5 ファミリー実行に、共有 GPT-5 プロンプト寄与を追加します。これはモデル ID によって適用されるため、レガシーの修復前参照（レガシー Codex GPT-5.5 参照）、openrouter/openai/gpt-5.5、opencode/gpt-5.5、その他の互換 GPT-5 参照などの OpenClaw/プロバイダールートは、同じオーバーレイを受け取ります。古い GPT-4.x モデルには適用されません。

バンドルされたネイティブ Codex ハーネスは、Codex アプリサーバーの開発者指示経由では、この OpenClaw GPT-5 オーバーレイを受け取りません。ネイティブ Codex は Codex 所有のベース、モデル、プロジェクトドキュメント動作を維持し、OpenClaw はネイティブスレッドで Codex の組み込みパーソナリティを無効化して、エージェントワークスペースのパーソナリティファイルを権威あるものにします。OpenClaw が寄与するのは、チャネル配信、OpenClaw 動的ツール、ACP 委任、ワークスペースコンテキスト、OpenClaw Skills などのランタイムコンテキストのみです。

GPT-5 寄与は、一致する OpenClaw 組み立てプロンプトに対して、ペルソナ永続性、実行安全性、ツール規律、出力形状、完了チェック、検証のタグ付き動作契約を追加します。チャネル固有の返信およびサイレントメッセージ動作は、共有 OpenClaw システムプロンプトと送信配信ポリシーに残ります。親しみやすい対話スタイルレイヤーは別個であり、構成可能です。

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

音声とスピーチ

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "openai",            model: "gpt-4o-transcribe",          },        ],      },    },  },}

Azure OpenAI エンドポイント

バンドルされた openai プロバイダーは、ベース URL を上書きすることで画像生成用の Azure OpenAI リソースを対象にできます。画像生成パスでは、OpenClaw は models.providers.openai.baseUrl 上の Azure ホスト名を検出し、自動的に Azure のリクエスト形状に切り替えます。

次の場合は Azure OpenAI を使用します。

• Azure OpenAI のサブスクリプション、クォータ、またはエンタープライズ契約をすでに持っている
• Azure が提供するリージョン内データ所在地またはコンプライアンス制御が必要
• 既存の Azure テナンシー内にトラフィックを維持したい

設定

バンドルされた openai プロバイダーを通じて Azure 画像生成を使うには、 models.providers.openai.baseUrl を Azure リソースに向け、apiKey を Azure OpenAI キー (OpenAI Platform キーではありません) に設定します。

{  models: {    providers: {      openai: {        baseUrl: "https://<your-resource>.openai.azure.com",        apiKey: "<azure-openai-api-key>",      },    },  },}

OpenClaw は、Azure 画像生成ルート用に次の Azure ホストサフィックスを認識します。

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

認識された Azure ホストへの画像生成リクエストでは、OpenClaw は次を行います。

• Authorization: Bearer の代わりに api-key ヘッダーを送信
• デプロイメントスコープのパス (/openai/deployments/{deployment}/...) を使用
• 各リクエストに ?api-version=... を追加
• Azure 画像生成呼び出しに 600 秒のデフォルトリクエストタイムアウトを使用。 呼び出しごとの timeoutMs 値は引き続きこのデフォルトを上書きします。

その他のベース URL (公開 OpenAI、OpenAI 互換プロキシ) は、標準の OpenAI 画像リクエスト形状を維持します。

API バージョン

Azure 画像生成パスで特定の Azure プレビュー版または GA バージョンに固定するには、 AZURE_OPENAI_API_VERSION を設定します。

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

変数が未設定の場合、デフォルトは 2024-12-01-preview です。

モデル名はデプロイメント名です

Azure OpenAI はモデルをデプロイメントにバインドします。バンドルされた openai プロバイダー経由でルーティングされる Azure 画像生成リクエストでは、OpenClaw の model フィールドは、公開 OpenAI モデル ID ではなく、Azure ポータルで設定した Azure デプロイメント名 でなければなりません。

gpt-image-2 を提供する gpt-image-2-prod というデプロイメントを作成した場合:

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

同じデプロイメント名ルールは、バンドルされた openai プロバイダーを通じて ルーティングされる画像生成呼び出しにも適用されます。

リージョン可用性

Azure 画像生成は現在、一部のリージョンでのみ利用できます (例: eastus2、swedencentral、polandcentral、westus3、 uaenorth)。デプロイメントを作成する前に Microsoft の現在のリージョン一覧を確認し、 対象のモデルが自分のリージョンで提供されていることを確認してください。

パラメーターの違い

Azure OpenAI と公開 OpenAI は、常に同じ画像パラメーターを受け付けるわけではありません。 Azure は、公開 OpenAI が許可するオプション (たとえば gpt-image-2 の特定の background 値) を拒否する場合や、特定のモデルバージョンでのみ公開する場合があります。 これらの違いは Azure と基盤モデルに由来するもので、OpenClaw ではありません。 Azure リクエストが検証エラーで失敗する場合は、Azure ポータルで特定のデプロイメントと API バージョンがサポートするパラメーターセットを確認してください。

高度な設定

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { serviceTier: "priority" } },      },    },  },}

{  agents: {    defaults: {      models: {        "azure-openai-responses/gpt-5.5": {          params: { responsesServerCompaction: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 120000,          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}

{  agents: {    defaults: {      embeddedAgent: { executionContract: "strict-agentic" },    },  },}

関連