OpenAI

• エージェントモデル - 明示的な agentRuntime 設定または OpenAI の暗黙的なルートポリシーによって選択されたランタイムを介する openai/*。ChatGPT/Codex サブスクリプションを使用する場合は Codex 認証でサインインし、キーに基づく課金を使用する場合は API キー認証 プロファイルを設定します。
• エージェント以外の OpenAI API - OPENAI_API_KEY または openai API キー認証プロファイルを介した、 使用量に応じて課金される OpenAI Platform への直接アクセス。
• レガシー設定 - codex/* および openai-codex/* の参照は、 openclaw doctor --fix によって openai/* とモデルスコープの agentRuntime.id: "codex" に 修復されます。

​

使用量とコストの追跡

• ChatGPT/Codex OAuth には、サブスクリプションプラン、クォータ期間、クレジット残高が表示されます。
• OPENAI_ADMIN_KEY は、Control UI の 使用量 に、プロバイダーから報告された組織のコストと completions 使用量の過去 30 日分を表示します。これには、日別支出、リクエスト数とトークン数の合計、上位モデル、コストカテゴリーが含まれます。
• OPENAI_PROJECT_ID を使用すると、Admin API の履歴を任意で 1 つのプロジェクトに限定できます。
• OpenClaw は、OPENAI_API_KEY または openai 推論プロファイルを組織 API に送信することはありません。これらの認証情報は、カスタム、Azure、またはエージェントローカルのエンドポイントに属している可能性があります。

​

クイック選択

​

名前の対応表

​

暗黙的なエージェントランタイム

​

GPT-5.6 限定プレビュー

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

OpenClaw の機能対応範囲

​

メモリ埋め込み

{
  memory: {
    search: {
      provider: "openai",
      model: "text-embedding-3-small",
    },
  },
}

​

はじめに

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.6" } } },
}

{
  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.6-sol

openclaw models list --provider openai

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

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

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

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

openclaw doctor --fix
openclaw config validate

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

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

{
  models: {
    providers: {
      openai: {
        models: [
          {
            id: "gpt-5.6-terra",
            name: "GPT-5.6 Terra",
            contextWindow: 1050000,
            contextTokens: 922000,
            maxTokens: 128000,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-terra" },
      models: {
        "openai/gpt-5.6-terra": {
          agentRuntime: { id: "openclaw" },
          params: {
            responsesServerCompaction: true,
            responsesCompactThreshold: 700000,
          },
        },
      },
    },
  },
}

​

ネイティブ Codex app-server の認証

1. エージェント用に順序付けられた OpenAI 認証プロファイル。できるだけ auth.order.openai の下に配置してください。古い従来の Codex 認証プロファイル ID と認証順序を 移行するには、openclaw doctor --fix を実行します。
2. ローカル Codex CLI の ChatGPT サインインなど、app-server の既存アカウント。 デフォルトの分離されたエージェントホームでは、OpenClaw はそのネイティブ CLI アカウントを ログイン RPC を介して app-server に橋渡しします。CLI の設定、plugins、スレッドストアは共有しません。
3. ローカル stdio app-server の起動時のみ、かつ app-server がアカウントなしと 報告した場合のみ、CODEX_API_KEY、続いて OPENAI_API_KEY。

​

画像生成

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "透明な背景上のシンプルな赤い円形ステッカー" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="macOS 上の OpenClaw 用の洗練されたローンチポスター" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="透明な背景上のシンプルな赤い円形ステッカー" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="オブジェクトの形状を維持し、素材を半透明のガラスに変更" image=/path/to/reference.png size=1024x1536

​

動画生成

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

​

GPT-5 プロンプトへの追加

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

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

​

音声とスピーチ

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

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

​

Azure OpenAI エンドポイント

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

​

設定

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

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

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

​

API バージョン

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

​

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

/tool image_generate model=openai/gpt-image-2-prod prompt="すっきりしたポスター" size=1024x1024 count=1

​

利用可能なリージョン

​

パラメーターの相違点

​

高度な設定

{
  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: "default" },
    },
  },
}

​

関連項目