OpenAI

• Modelli dell’agente - openai/* tramite il runtime selezionato dalla configurazione esplicita agentRuntime o dal criterio implicito della route di OpenAI. Accedere con l’autenticazione Codex per utilizzare l’abbonamento ChatGPT/Codex oppure configurare un profilo di autenticazione tramite chiave API quando si desidera la fatturazione basata sulla chiave.
• API OpenAI non destinate agli agenti - accesso diretto alla piattaforma OpenAI, con fatturazione in base all’uso, tramite OPENAI_API_KEY o un profilo di autenticazione tramite chiave API openai.
• Configurazione legacy - i riferimenti codex/* e openai-codex/* vengono corretti in openai/* più agentRuntime.id: "codex" con ambito limitato al modello da openclaw doctor --fix.

​

Monitoraggio dell’utilizzo e dei costi

• OAuth ChatGPT/Codex mostra il piano di abbonamento, le finestre delle quote e il saldo dei crediti.
• OPENAI_ADMIN_KEY mostra 30 giorni di costi dell’organizzazione e utilizzo dei completamenti segnalati dal provider nella sezione Utilizzo dell’interfaccia di controllo, inclusi spesa giornaliera, totali di richieste/token, modelli principali e categorie di costo.
• OPENAI_PROJECT_ID limita facoltativamente la cronologia dell’API di amministrazione a un singolo progetto.
• OpenClaw non invia mai OPENAI_API_KEY o un profilo di inferenza openai alle API dell’organizzazione; tali credenziali possono appartenere a endpoint personalizzati, Azure o locali dell’agente.

​

Scelta rapida

​

Mappa dei nomi

​

Runtime implicito dell’agente

​

Anteprima limitata di GPT-5.6

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

Copertura delle funzionalità di OpenClaw

​

Embedding della memoria

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

​

Introduzione

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 }],
      },
    },
  },
}

​

Autenticazione nativa dell’app-server Codex

1. Profili di autenticazione OpenAI ordinati per l’agente, preferibilmente in auth.order.openai. Eseguire openclaw doctor --fix per migrare i precedenti ID profilo di autenticazione Codex legacy e il relativo ordine.
2. L’account esistente dell’app-server, ad esempio un accesso ChatGPT della CLI Codex locale. Per la home isolata predefinita dell’agente, OpenClaw collega tale account CLI nativo all’app-server tramite la relativa RPC di accesso; non condivide la configurazione, i plugin o l’archivio dei thread della CLI.
3. Solo per gli avvii locali dell’app-server tramite stdio e solo quando l’app-server non segnala alcun account: CODEX_API_KEY, quindi OPENAI_API_KEY.

​

Generazione di immagini

{
  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 semplice adesivo circolare rosso su sfondo trasparente" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="Un poster di lancio professionale per OpenClaw su macOS" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="Un semplice adesivo circolare rosso su sfondo trasparente" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="Mantieni la forma dell'oggetto e cambia il materiale in vetro traslucido" image=/path/to/reference.png size=1024x1536

​

Generazione di video

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

​

Contributo al prompt GPT-5

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

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

​

Voce e parlato

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

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

​

Endpoint Azure OpenAI

• È già disponibile una sottoscrizione, una quota o un contratto aziendale Azure OpenAI
• Sono necessari la residenza regionale dei dati o i controlli di conformità forniti da Azure
• Si desidera mantenere il traffico all’interno di un tenant Azure esistente

​

Configurazione

{
  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

• Invia l’header api-key invece di Authorization: Bearer
• Utilizza percorsi specifici per la distribuzione (/openai/deployments/{deployment}/...)
• Aggiunge ?api-version=... a ogni richiesta
• Utilizza un timeout predefinito di 600s per le richieste di generazione di immagini Azure. I valori timeoutMs per singola chiamata continuano a sostituire questo valore predefinito.

​

Versione API

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

​

I nomi dei modelli sono nomi di distribuzione

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

​

Disponibilità regionale

​

Differenze nei parametri

​

Configurazione avanzata

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

​

Argomenti correlati