Langsung ke konten utama
Cloudflare AI Gateway berada di depan API penyedia dan memungkinkan Anda menambahkan analitik, caching, dan kontrol. Untuk Anthropic, OpenClaw menggunakan Anthropic Messages API melalui titik akhir Gateway Anda.
PropertiNilai
Penyediacloudflare-ai-gateway
URL Dasarhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Model bawaancloudflare-ai-gateway/claude-sonnet-4-6
Kunci APICLOUDFLARE_AI_GATEWAY_API_KEY (kunci API penyedia Anda untuk permintaan melalui Gateway)
Untuk model Anthropic yang dirutekan melalui Cloudflare AI Gateway, gunakan kunci API Anthropic Anda sebagai kunci penyedia.
Saat thinking diaktifkan untuk model Anthropic Messages, OpenClaw menghapus giliran pengisian awal asisten di akhir sebelum mengirim payload melalui Cloudflare AI Gateway. Anthropic menolak pengisian awal respons dengan extended thinking, sementara pengisian awal non-thinking biasa tetap tersedia.

​
Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Memulai

1

Atur kunci API penyedia dan detail Gateway

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

Atur model bawaan

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

Verifikasi bahwa model tersedia

openclaw models list --provider cloudflare-ai-gateway

​
Contoh non-interaktif

Untuk penyiapan berbasis skrip atau CI, berikan semua nilai pada baris perintah: 
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 sebagai tambahan untuk kunci API penyedia 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 kunci API penyedia (misalnya, kunci Anthropic Anda) mengautentikasi ke penyedia upstream.
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan CLOUDFLARE_AI_GATEWAY_API_KEY tersedia untuk proses tersebut.
Kunci yang diekspor hanya di shell interaktif tidak akan membantu daemon launchd/systemd kecuali lingkungan tersebut juga diimpor ke sana. Atur kunci di ~/.openclaw/.env atau melalui env.shellEnv untuk memastikan proses Gateway dapat membacanya.

​
Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.