Langsung ke konten utama

​
Cloudflare AI Gateway

Cloudflare AI Gateway berada di depan API provider dan memungkinkan Anda menambahkan analitik, caching, dan kontrol. Untuk Anthropic, OpenClaw menggunakan Anthropic Messages API melalui endpoint Gateway Anda.
PropertyValue
Providercloudflare-ai-gateway
Base URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Default modelcloudflare-ai-gateway/claude-sonnet-4-5
API keyCLOUDFLARE_AI_GATEWAY_API_KEY (API key provider Anda untuk permintaan melalui Gateway)
Untuk model Anthropic yang dirutekan melalui Cloudflare AI Gateway, gunakan Anthropic API key Anda sebagai key provider.

​
Memulai

1

Setel API key provider dan detail Gateway

Jalankan onboarding dan pilih opsi auth Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Ini akan meminta ID akun, ID gateway, dan API key Anda.
2

Setel model default

Tambahkan model ke konfigurasi OpenClaw Anda:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}
3

Verifikasi model tersedia

openclaw models list --provider cloudflare-ai-gateway

​
Contoh non-interaktif

Untuk penyiapan terotomatisasi atau CI, berikan semua nilai di command line: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

​
Konfigurasi lanjutan

Jika Anda mengaktifkan autentikasi Gateway di Cloudflare, tambahkan header cf-aig-authorization. Ini selain API key provider Anda.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
Header cf-aig-authorization mengautentikasi ke Cloudflare Gateway itu sendiri, sedangkan API key provider (misalnya, key Anthropic Anda) mengautentikasi ke provider upstream.
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan CLOUDFLARE_AI_GATEWAY_API_KEY tersedia untuk proses tersebut.
Key yang hanya ada di ~/.profile tidak akan membantu daemon launchd/systemd kecuali environment tersebut juga diimpor ke sana. Setel key di ~/.openclaw/.env atau melalui env.shellEnv untuk memastikan proses gateway dapat membacanya.

​
Terkait

Pemilihan model

Memilih provider, ref model, dan perilaku failover.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.