OpenAI

• Modèles d’agent - openai/* via l’environnement d’exécution sélectionné par une configuration agentRuntime explicite ou par la politique de route implicite d’OpenAI. Connectez-vous avec l’authentification Codex pour utiliser un abonnement ChatGPT/Codex, ou configurez un profil d’authentification par clé d’API si vous souhaitez une facturation basée sur une clé.
• API OpenAI hors agent - accès direct à OpenAI Platform, facturé à l’utilisation, via OPENAI_API_KEY ou un profil d’authentification par clé d’API openai.
• Configuration héritée - les références codex/* et openai-codex/* sont corrigées en openai/*, avec agentRuntime.id: "codex" limité au modèle, par openclaw doctor --fix.

​

Suivi de l’utilisation et des coûts

• L’OAuth ChatGPT/Codex affiche le forfait d’abonnement, les fenêtres de quota et le solde de crédits.
• OPENAI_ADMIN_KEY affiche 30 jours de coûts d’organisation et d’utilisation des complétions communiqués par le fournisseur dans Utilisation de l’interface de contrôle, notamment les dépenses quotidiennes, les totaux de requêtes et de jetons, les principaux modèles et les catégories de coûts.
• OPENAI_PROJECT_ID limite facultativement l’historique de l’API d’administration à un seul projet.
• OpenClaw n’envoie jamais OPENAI_API_KEY ni un profil d’inférence openai aux API de l’organisation ; ces identifiants peuvent appartenir à des points de terminaison personnalisés, Azure ou locaux à l’agent.

​

Choix rapide

​

Correspondance des noms

​

Environnement d’exécution implicite de l’agent

​

Aperçu limité de GPT-5.6

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

Couverture fonctionnelle d’OpenClaw

​

Plongements de mémoire

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

​

Prise en main

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.5", contextTokens: 160000 }],
      },
    },
  },
}

​

Authentification du serveur d’application Codex natif

1. Profils d’authentification OpenAI ordonnés pour l’agent, de préférence sous auth.order.openai. Exécutez openclaw doctor --fix pour migrer les anciens identifiants de profil d’authentification Codex et l’ordre d’authentification hérités.
2. Compte existant du serveur d’application, par exemple une connexion ChatGPT locale dans la CLI Codex. Pour le répertoire personnel isolé par défaut de l’agent, OpenClaw transmet ce compte CLI natif au serveur d’application via son RPC de connexion ; il ne partage pas la configuration, les plugins ni le magasin de fils de discussion de la CLI.
3. Pour les lancements locaux du serveur d’application via stdio uniquement, et seulement lorsque celui-ci ne signale aucun compte : CODEX_API_KEY, puis OPENAI_API_KEY.

​

Génération d’images

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "Un autocollant représentant un simple cercle rouge sur un arrière-plan transparent" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="Une affiche de lancement soignée pour OpenClaw sur macOS" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="Un autocollant représentant un simple cercle rouge sur un arrière-plan transparent" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="Conserver la forme de l’objet et remplacer le matériau par du verre translucide" image=/path/to/reference.png size=1024x1536

​

Génération de vidéos

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

​

Contribution à l’invite GPT-5

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

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

​

Voix et parole

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

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

​

Points de terminaison Azure OpenAI

• Vous disposez déjà d’un abonnement Azure OpenAI, d’un quota ou d’un contrat d’entreprise
• Vous avez besoin de la résidence régionale des données ou des contrôles de conformité fournis par Azure
• Vous souhaitez conserver le trafic au sein d’un locataire Azure existant

​

Configuration

{
  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

• Envoie l’en-tête api-key au lieu de Authorization: Bearer
• Utilise des chemins propres au déploiement (/openai/deployments/{deployment}/...)
• Ajoute ?api-version=... à chaque requête
• Utilise un délai d’expiration de requête par défaut de 600s pour les appels de génération d’images Azure. Les valeurs timeoutMs propres à chaque appel remplacent toujours cette valeur par défaut.

​

Version de l’API

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

​

Les noms de modèles sont des noms de déploiements

/tool image_generate model=openai/gpt-image-2-prod prompt="Une affiche épurée" size=1024x1024 count=1

​

Disponibilité régionale

​

Différences entre les paramètres

​

Configuration avancée

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

​

Voir aussi