Gateway AI Cloudflare

Cloudflare AI Gateway berada di depan API penyedia dan menambahkan analitik, penyimpanan cache, serta kontrol. Untuk Anthropic, OpenClaw menggunakan Anthropic Messages API melalui titik akhir Gateway Anda.

Properti	Nilai
Penyedia	`cloudflare-ai-gateway`
Plugin	paket eksternal resmi (`@openclaw/cloudflare-ai-gateway-provider`)
URL dasar	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Model bawaan	`cloudflare-ai-gateway/claude-sonnet-4-6`
Kunci API	`CLOUDFLARE_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 proses berpikir diaktifkan untuk model Anthropic Messages, OpenClaw menghapus giliran prapengisian asisten di bagian akhir sebelum mengirimkan muatan melalui Cloudflare AI Gateway. Anthropic menolak prapengisian respons dengan proses berpikir yang diperluas, sedangkan prapengisian biasa tanpa proses berpikir tetap tersedia.

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:

openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

Memulai

Tetapkan kunci API penyedia dan detail Gateway

Jalankan orientasi awal dan pilih opsi autentikasi Cloudflare AI Gateway:

openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

Perintah ini akan meminta ID akun, ID gateway, dan kunci API Anda.

Tetapkan model bawaan

Tambahkan model ke konfigurasi OpenClaw Anda:

{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}

Verifikasi bahwa model tersedia

openclaw models list --provider cloudflare-ai-gateway

Contoh noninteraktif

Untuk penyiapan berbasis skrip atau CI, teruskan semua nilai melalui 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

Gateway terautentikasi

Jika Anda mengaktifkan autentikasi Gateway di Cloudflare, tambahkan header cf-aig-authorization. Header ini diperlukan selain kunci API penyedia Anda.

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

Header cf-aig-authorization melakukan autentikasi dengan Cloudflare Gateway itu sendiri, sedangkan kunci API penyedia (misalnya, kunci Anthropic Anda) melakukan autentikasi dengan penyedia hulu.

Catatan lingkungan

Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan CLOUDFLARE_AI_GATEWAY_API_KEY tersedia bagi proses tersebut.

Kunci yang hanya diekspor dalam shell interaktif tidak akan tersedia bagi daemon launchd/systemd, kecuali lingkungan tersebut juga diimpor ke sana. Tetapkan kunci di ~/.openclaw/.env atau melalui env.shellEnv untuk memastikan proses gateway dapat membacanya.

Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku pengalihan saat terjadi kegagalan.

Pemecahan masalah

Pemecahan masalah umum dan pertanyaan umum.

Overview

Concepts and configuration

Providers

Gateway AI Cloudflare

Instal Plugin

Memulai

Contoh noninteraktif

Konfigurasi lanjutan

Terkait

Pemilihan model

Pemecahan masalah

​Instal Plugin

​Memulai

​Contoh noninteraktif

​Konfigurasi lanjutan

​Terkait

Pemilihan model

Pemecahan masalah

Instal Plugin

Memulai

Contoh noninteraktif

Konfigurasi lanjutan

Terkait