OpenAI

• Ajan modelleri - açık agentRuntime yapılandırması veya OpenAI’ın örtük rota ilkesiyle seçilen çalışma zamanı üzerinden openai/*. ChatGPT/Codex aboneliği kullanımı için Codex kimlik doğrulamasıyla oturum açın veya anahtar tabanlı faturalandırma istediğinizde bir API anahtarı kimlik doğrulama profili yapılandırın.
• Ajan dışı OpenAI API’leri - OPENAI_API_KEY veya bir openai API anahtarı kimlik doğrulama profili üzerinden, kullanım başına faturalandırılan doğrudan OpenAI Platform erişimi.
• Eski yapılandırma - codex/* ve openai-codex/* başvuruları, openclaw doctor --fix tarafından openai/* ile model kapsamlı agentRuntime.id: "codex" biçimine onarılır.

​

Kullanım ve maliyet takibi

• ChatGPT/Codex OAuth; abonelik planını, kota aralıklarını ve kredi bakiyesini gösterir.
• OPENAI_ADMIN_KEY, Control UI Kullanım bölümünde günlük harcama, istek/token toplamları, en çok kullanılan modeller ve maliyet kategorileri dâhil olmak üzere sağlayıcının bildirdiği 30 günlük kuruluş maliyetini ve tamamlama kullanımını gösterir.
• OPENAI_PROJECT_ID, isteğe bağlı olarak Admin API geçmişini tek bir projeyle sınırlar.
• OpenClaw, OPENAI_API_KEY veya bir openai çıkarım profilini kuruluş API’lerine asla göndermez; bu kimlik bilgileri özel, Azure veya ajan yerel uç noktalarına ait olabilir.

​

Hızlı seçim

​

Adlandırma eşlemesi

​

Örtük ajan çalışma zamanı

​

GPT-5.6 sınırlı önizlemesi

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

OpenClaw özellik kapsamı

​

Bellek gömme vektörleri

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

​

Başlarken

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

​

Yerel Codex app-server kimlik doğrulaması

1. Ajan için tercihen auth.order.openai altında sıralanmış OpenAI kimlik doğrulama profilleri. Eski Codex kimlik doğrulama profili kimliklerini ve kimlik doğrulama sırasını taşımak için openclaw doctor --fix çalıştırın.
2. Yerel Codex CLI ChatGPT oturum açması gibi app-server’ın mevcut hesabı. Varsayılan yalıtılmış ajan ana dizini için OpenClaw, bu yerel CLI hesabını oturum açma RPC’si üzerinden app-server’a bağlar; CLI’ın yapılandırmasını, pluginlerini veya iş parçacığı deposunu paylaşmaz.
3. Yalnızca yerel stdio app-server başlatmaları için ve yalnızca app-server hesap olmadığını bildirdiğinde: CODEX_API_KEY, ardından OPENAI_API_KEY.

​

Görsel oluşturma

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "Şeffaf bir arka plan üzerinde basit bir kırmızı daire çıkartması" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="macOS'te OpenClaw için özenle hazırlanmış bir lansman posteri" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="Şeffaf bir arka plan üzerinde basit bir kırmızı daire çıkartması" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="Nesnenin şeklini koru, malzemeyi yarı saydam cama dönüştür" image=/path/to/reference.png size=1024x1536

​

Video oluşturma

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

​

GPT-5 istem katkısı

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

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

​

Ses ve konuşma

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

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

​

Azure OpenAI uç noktaları

• Zaten bir Azure OpenAI aboneliğiniz, kotanız veya kurumsal sözleşmeniz varsa
• Azure’un sağladığı bölgesel veri yerleşimi veya uyumluluk denetimlerine ihtiyacınız varsa
• Trafiği mevcut bir Azure kiracısı içinde tutmak istiyorsanız

​

Yapılandırma

{
  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 yerine api-key üst bilgisini gönderir
• Dağıtım kapsamlı yolları (/openai/deployments/{deployment}/...) kullanır
• Her isteğe ?api-version=... ekler
• Azure görüntü oluşturma çağrıları için varsayılan 600s istek zaman aşımını kullanır. Çağrı başına timeoutMs değerleri yine de bu varsayılanı geçersiz kılar.

​

API sürümü

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

​

Model adları dağıtım adlarıdır

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

​

Bölgesel kullanılabilirlik

​

Parametre farklılıkları

​

Gelişmiş yapılandırma

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

​

İlgili