Ana içeriğe atla

Vercel AI Gateway

Vercel AI Gateway, yüzlerce modele tek bir uç nokta üzerinden erişmek için birleşik bir API sağlar.
ÖzellikDeğer
Sağlayıcıvercel-ai-gateway
AuthAI_GATEWAY_API_KEY
APIAnthropic Messages ile uyumlu
Model kataloğu/v1/models üzerinden otomatik keşfedilir
OpenClaw, Gateway /v1/models kataloğunu otomatik olarak keşfeder; bu nedenle /models vercel-ai-gateway, vercel-ai-gateway/openai/gpt-5.4 gibi güncel model referanslarını içerir.

Başlangıç

1

API anahtarını ayarlayın

Onboarding’i çalıştırın ve AI Gateway auth seçeneğini seçin:
openclaw onboard --auth-choice ai-gateway-api-key
2

Varsayılan bir model ayarlayın

Modeli OpenClaw yapılandırmanıza ekleyin:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider vercel-ai-gateway

Etkileşimsiz örnek

Script’li veya CI kurulumları için tüm değerleri komut satırında geçin:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Model kimliği kısaltması

OpenClaw, Vercel Claude kısaltılmış model referanslarını kabul eder ve bunları çalışma zamanında normalize eder:
Kısaltılmış girdiNormalize edilmiş model referansı
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
Yapılandırmanızda kısaltılmış biçimi veya tam nitelikli model referansını kullanabilirsiniz. OpenClaw, kanonik biçimi otomatik olarak çözer.

Gelişmiş notlar

OpenClaw Gateway bir daemon olarak çalışıyorsa (launchd/systemd), AI_GATEWAY_API_KEY değerinin o süreç için erişilebilir olduğundan emin olun.
Yalnızca ~/.profile içinde ayarlanmış bir anahtar, bu ortam açıkça içe aktarılmadıkça launchd/systemd daemon’u tarafından görünmez. Gateway sürecinin bu anahtarı okuyabilmesini sağlamak için anahtarı ~/.openclaw/.env içinde veya env.shellEnv üzerinden ayarlayın.
Vercel AI Gateway, istekleri model referansı önekine göre upstream sağlayıcıya yönlendirir. Örneğin vercel-ai-gateway/anthropic/claude-opus-4.6, Anthropic üzerinden yönlendirilirken vercel-ai-gateway/openai/gpt-5.4 OpenAI üzerinden yönlendirilir. Tek bir AI_GATEWAY_API_KEY, tüm upstream sağlayıcılar için kimlik doğrulamayı yönetir.

İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve failover davranışını seçme.

Sorun giderme

Genel sorun giderme ve SSS.