OpenClaw mit OpenAI verbinden: API-Key oder Codex-Login

Kennst du das? Du willst die Power von GPT-Modellen nutzen, aber das Jonglieren mit API-Keys und verschiedenen Abonnements nervt. OpenClaw hilft dir dabei, diese Welten zu verbinden und das Beste aus beiden Optionen herauszuholen.

OpenAI

OpenAI bietet APIs für GPT-Modelle an. Codex unterstützt den ChatGPT sign-in für den Zugriff über dein Abonnement oder den API key sign-in für eine nutzungsbasierte Abrechnung. Die Codex cloud setzt einen ChatGPT sign-in voraus. OpenAI unterstützt die Nutzung von Subscription OAuth in externen Tools wie OpenClaw offiziell.

Option A: OpenAI API-Key (OpenAI Plattform)

Am besten für: direkten API-Zugriff und Abrechnung nach Verbrauch. Hol dir deinen API-Key im OpenAI Dashboard.

CLI-Setup

openclaw onboard --auth-choice openai-api-key
# or non-interactive
openclaw onboard --openai-api-key "$OPENAI_API_KEY"

Konfigurations-Snippet

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}

Die aktuellen API-Modell-Docs von OpenAI führen gpt-5.4 und gpt-5.4-pro für die direkte API-Nutzung auf. OpenClaw leitet beide über den openai/* Responses Pfad weiter. OpenClaw blendet die veraltete Zeile openai/gpt-5.3-codex-spark bewusst aus, da direkte OpenAI API-Aufrufe diese im Live-Betrieb ablehnen.

OpenClaw stellt openai/gpt-5.3-codex-spark nicht über den direkten OpenAI API Pfad bereit. pi-ai enthält zwar noch eine integrierte Zeile für dieses Modell, aber Live-Anfragen an die OpenAI API lehnen sie aktuell ab. Spark wird in OpenClaw als Codex-only behandelt.

Option B: OpenAI Code (Codex) Abonnement

Am besten für: die Nutzung deines ChatGPT/Codex Abonnements anstelle eines API-Keys. Die Codex cloud erfordert einen ChatGPT sign-in, während das Codex CLI sowohl ChatGPT als auch API-Keys unterstützt.

CLI-Setup (Codex OAuth)

# Run Codex OAuth in the wizard
openclaw onboard --auth-choice openai-codex

# Or run OAuth directly
openclaw models auth login --provider openai-codex

Konfigurations-Snippet (Codex Abonnement)

{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
}

Die Codex-Docs von OpenAI listen gpt-5.4 als aktuelles Codex-Modell. OpenClaw mappt das

{
  agents: {
    defaults: {
      model: { primary: "openai-codex/gpt-5.4" },
      models: {
        "openai-codex/gpt-5.4": {
          params: {
            transport: "auto",
          },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: false,
          },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: true,
          },
        },
      },
    },
  },
}

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

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            fastMode: true,
          },
        },
        "openai-codex/gpt-5.4": {
          params: {
            fastMode: true,
          },
        },
      },
    },
  },
}

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

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

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