Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway berada di depan API penyedia dan memungkinkan Anda menambahkan analitik, caching, dan kontrol. Untuk Anthropic, OpenClaw menggunakan Anthropic Messages API melalui endpoint Gateway Anda.
PropertiNilai
Penyediacloudflare-ai-gateway
URL Dasarhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Model defaultcloudflare-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 prefill asisten di akhir sebelum mengirim payload melalui Cloudflare AI Gateway. Anthropic menolak prefilling respons dengan extended thinking, sementara prefill non-thinking biasa tetap tersedia.

​
Memulai

1

Set the provider API key and Gateway details

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

Set a default model

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

Verify the model is available

openclaw models list --provider cloudflare-ai-gateway

​
Contoh non-interaktif

Untuk penyiapan skrip atau CI, teruskan semua nilai di 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 dari kunci API penyedia Anda.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
Header cf-aig-authorization mengautentikasi dengan Cloudflare Gateway itu sendiri, sementara kunci API penyedia (misalnya, kunci Anthropic Anda) mengautentikasi dengan penyedia upstream.
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan CLOUDFLARE_AI_GATEWAY_API_KEY tersedia untuk proses tersebut.
Kunci yang hanya berada di ~/.profile tidak akan membantu daemon launchd/systemd kecuali environment tersebut juga diimpor ke sana. Tetapkan kunci di ~/.openclaw/.env atau melalui env.shellEnv untuk memastikan proses gateway dapat membacanya.

​
Terkait

Model selection

Memilih penyedia, referensi model, dan perilaku failover.

Troubleshooting

Pemecahan masalah umum dan FAQ.