Langsung ke konten utama
Anthropic membangun keluarga model Claude. OpenClaw mendukung dua rute autentikasi:
  • Kunci API — akses Anthropic API langsung dengan penagihan berbasis penggunaan (model anthropic/*)
  • Claude CLI — gunakan kembali login Claude Code yang sudah ada pada host yang sama
Backend Claude CLI OpenClaw menjalankan Claude Code CLI yang terpasang dalam mode cetak non-interaktif. Dokumentasi Claude Code Anthropic saat ini menjelaskan claude -p sebagai penggunaan Agent SDK/terprogram. Pembaruan dukungan Anthropic pada 15 Juni 2026 menjeda perubahan penagihan Agent SDK yang diumumkan. Untuk saat ini, Anthropic mengatakan penggunaan Claude Agent SDK, claude -p, dan aplikasi pihak ketiga masih mengambil dari batas penggunaan langganan. Kredit Agent SDK bulanan yang sebelumnya diumumkan tidak tersedia selama Anthropic merevisi rencana tersebut.Claude Code interaktif tetap mengambil dari batas paket Claude yang sudah masuk. Autentikasi kunci API tetap berupa penagihan API langsung bayar sesuai pemakaian. Untuk host gateway jangka panjang, otomasi bersama, dan pengeluaran produksi yang dapat diprediksi, gunakan kunci API Anthropic.Periksa artikel dukungan Anthropic saat ini sebelum mengandalkan perilaku penagihan langganan:

​
Memulai

Terbaik untuk: akses API standar dan penagihan berbasis penggunaan.
1

Dapatkan kunci API Anda

Buat kunci API di Anthropic Console.
2

Jalankan onboarding

openclaw onboard
# choose: Anthropic API key
Atau teruskan kunci secara langsung:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Verifikasi model tersedia

openclaw models list --provider anthropic

​
Contoh konfigurasi

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

​
Default thinking (Claude Fable 5, 4.8, dan 4.6)

anthropic/claude-fable-5 selalu menggunakan thinking adaptif dan default ke upaya high. Karena Anthropic tidak mengizinkan thinking dinonaktifkan untuk model ini, /think off dan /think minimal menggunakan upaya low. OpenClaw juga menghilangkan nilai temperature kustom untuk permintaan Fable 5. Claude Opus 4.8 menjaga thinking nonaktif secara default di OpenClaw. Saat Anda secara eksplisit mengaktifkan thinking adaptif dengan /think high|xhigh|max, OpenClaw mengirim nilai upaya Opus 4.8 Anthropic; model Claude 4.6 default ke adaptive. Override per pesan dengan /think:<level> atau di parameter model: 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
Dokumentasi Anthropic terkait:

​
Fallback penolakan keselamatan (Claude Fable 5)

Menggunakan Claude Fable 5 berarti juga menggunakan Claude Opus 4.8. Fable 5 dikirim dengan pengklasifikasi keselamatan yang dapat menolak permintaan, dan pemulihan yang disetujui Anthropic adalah meminta claude-opus-4-8 melayani giliran tersebut. OpenClaw ikut serta dalam ini secara otomatis untuk permintaan kunci API langsung, sehingga beberapa giliran Fable dijawab dan ditagih sebagai Claude Opus 4.8. Jika kebijakan atau anggaran Anda tidak dapat menerima giliran yang dilayani Opus, jangan pilih anthropic/claude-fable-5.

​
Mengapa ini ada

Pengklasifikasi Fable 5 mengembalikan stop_reason: "refusal" pada permintaan di domain terbatas, dan juga salah positif pada pekerjaan yang berdekatan dengan benign (tooling keamanan, ilmu hayati, atau bahkan meminta model mereproduksi penalaran mentahnya). Tanpa fallback, giliran tersebut gagal dengan kesalahan meskipun model Claude lain akan melayaninya dengan lancar — pesan penolakan Anthropic sendiri memberi tahu integrator API untuk mengonfigurasi model fallback.

​
Cara kerjanya

  1. Untuk setiap permintaan kunci API langsung ke anthropic/claude-fable-5, OpenClaw mengirim opt-in fallback sisi server Anthropic: header beta server-side-fallback-2026-06-01 plus fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 adalah satu-satunya target fallback yang diizinkan Anthropic untuk Fable 5.
  2. Hanya penolakan pengklasifikasi keselamatan yang memicu fallback. Batas laju, overload, dan kesalahan server berperilaku persis seperti sebelumnya dan melalui failover model normal OpenClaw.
  3. Penyelamatan terjadi di dalam panggilan yang sama. Penolakan sebelum output apa pun tidak terlihat selain latensi; seluruh jawaban berasal dari Opus 4.8. Pada penolakan di tengah streaming, teks parsial dipertahankan sebagai prefiks yang dilanjutkan model fallback, sementara penalaran dan panggilan alat model yang ditolak dibuang sesuai aturan replay Anthropic (tidak boleh digaungkan kembali atau dieksekusi).
  4. Jika Claude Opus 4.8 juga menolak, giliran menampilkan penolakan sebagai kesalahan, persis seperti sebelum fitur ini.
Fallback terjadi pada level Anthropic API, sehingga claude-opus-4-8 tidak perlu ada dalam daftar model atau rantai fallback yang dikonfigurasi — kunci API yang mendukung Fable selalu dapat melayani Opus.

​
Observabilitas dan penagihan

  • Giliran yang dilayani fallback mencatat diagnostik provider_fallback pada pesan asisten yang menamai fromModel dan toModel, dan responseModel pesan melaporkan claude-opus-4-8.
  • Anthropic menagih per upaya: penolakan sebelum output gratis, dan penyelamatan ditagih dengan tarif Claude Opus 4.8 (saat ini setengah dari tarif Fable 5). Estimasi biaya per giliran OpenClaw memberi harga giliran yang dilayani fallback dengan tarif Opus agar sesuai.
  • Penolakan di tengah streaming juga menagih parsial Fable yang sudah distream di sisi Anthropic; bagian tersebut dilaporkan dalam penggunaan per upaya API tetapi tidak dimasukkan ke estimasi per giliran OpenClaw.

​
Cakupan

Berlaku untuk anthropic/claude-fable-5 dengan autentikasi kunci API terhadap api.anthropic.com. OAuth (penggunaan kembali langganan Claude CLI), URL dasar proksi, permintaan Bedrock, Vertex, dan Foundry tidak berubah dan tetap menampilkan penolakan sebagai kesalahan di sana. Terverifikasi secara live: prompt benign yang meminta Fable 5 mereproduksi chain of thought mentahnya ditolak dengan category: "reasoning_extraction" saat dikirim tanpa fallback, dan prompt yang sama melalui OpenClaw mengembalikan jawaban normal yang dilayani Opus dengan diagnostik provider_fallback terlampir. Lihat panduan penolakan dan fallback Anthropic untuk perilaku dasarnya.

​
Caching prompt

OpenClaw mendukung fitur caching prompt Anthropic untuk autentikasi kunci API.
NilaiDurasi cacheDeskripsi
"short" (default)5 menitDiterapkan otomatis untuk autentikasi kunci API
"long"1 jamCache diperpanjang
"none"Tanpa cachingNonaktifkan caching prompt
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Gunakan parameter level model sebagai baseline Anda, lalu override agen tertentu melalui agents.list[].params:
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } },
    ],
  },
}
Urutan penggabungan konfigurasi:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (id yang cocok, menimpa berdasarkan kunci)
Ini memungkinkan satu agen mempertahankan cache berumur panjang sementara agen lain pada model yang sama menonaktifkan caching untuk lalu lintas yang melonjak/penggunaan ulang rendah.
  • Model Anthropic Claude di Bedrock (amazon-bedrock/*anthropic.claude*) menerima pass-through cacheRetention saat dikonfigurasi.
  • Model Bedrock non-Anthropic dipaksa ke cacheRetention: "none" saat runtime.
  • Default cerdas kunci API juga mengisi cacheRetention: "short" untuk referensi Claude-on-Bedrock saat tidak ada nilai eksplisit yang ditetapkan.

​
Konfigurasi lanjutan

Toggle /fast bersama OpenClaw mendukung lalu lintas Anthropic langsung (kunci API dan OAuth ke api.anthropic.com).
PerintahDipetakan ke
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Hanya disuntikkan untuk permintaan langsung api.anthropic.com. Rute proxy membiarkan service_tier tidak berubah.
  • Parameter eksplisit serviceTier atau service_tier menimpa /fast saat keduanya ditetapkan.
  • Pada akun tanpa kapasitas Priority Tier, service_tier: "auto" dapat diselesaikan menjadi standard.
Plugin Anthropic bawaan mendaftarkan pemahaman gambar dan PDF. OpenClaw menyelesaikan otomatis kapabilitas media dari autentikasi Anthropic yang dikonfigurasi — tidak diperlukan konfigurasi tambahan.
PropertiNilai
Model defaultclaude-opus-4-8
Input yang didukungGambar, dokumen PDF
Saat gambar atau PDF dilampirkan ke percakapan, OpenClaw secara otomatis merutekannya melalui penyedia pemahaman media Anthropic.
Jendela konteks 1M Anthropic tersedia pada model Claude 4.x berkemampuan GA seperti Opus 4.8, Opus 4.7, Opus 4.6, dan Sonnet 4.6. OpenClaw mengukur model tersebut pada 1M secara otomatis:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
Konfigurasi lama dapat tetap memakai params.context1m: true, tetapi OpenClaw tidak lagi mengirim header beta context-1m-2025-08-07 yang sudah dihentikan. Entri konfigurasi anthropicBeta lama dengan nilai tersebut diabaikan selama resolusi header permintaan dan model Claude lama yang tidak didukung tetap berada pada jendela konteks normalnya.params.context1m: true juga berlaku untuk backend Claude CLI (claude-cli/*) untuk model Opus dan Sonnet berkemampuan GA yang memenuhi syarat, sehingga jendela konteks runtime untuk sesi CLI tersebut tetap sesuai dengan perilaku API langsung.
Memerlukan akses konteks panjang pada kredensial Anthropic Anda. Autentikasi token OAuth/langganan mempertahankan header beta Anthropic yang diwajibkan, tetapi OpenClaw menghapus header beta 1M yang sudah dihentikan jika masih ada di konfigurasi lama.
anthropic/claude-opus-4-8 dan varian claude-cli-nya memiliki jendela konteks 1M secara default — tidak perlu params.context1m: true.

​
Pemecahan masalah

Autentikasi token Anthropic kedaluwarsa dan dapat dicabut. Untuk penyiapan baru, gunakan kunci API Anthropic sebagai gantinya.
Autentikasi Anthropic bersifat per agen — agen baru tidak mewarisi kunci agen utama. Jalankan ulang onboarding untuk agen tersebut (atau konfigurasikan kunci API pada host Gateway), lalu verifikasi dengan openclaw models status.
Jalankan openclaw models status untuk melihat profil autentikasi mana yang aktif. Jalankan ulang onboarding, atau konfigurasikan kunci API untuk path profil tersebut.
Periksa openclaw models status --json untuk auth.unusableProfiles. Cooldown batas laju Anthropic dapat bersifat spesifik model, sehingga model Anthropic saudara mungkin masih dapat digunakan. Tambahkan profil Anthropic lain atau tunggu cooldown.
Bantuan lainnya: Pemecahan masalah dan FAQ.

​
Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

Backend CLI

Penyiapan backend Claude CLI dan detail runtime.

Caching prompt

Cara kerja caching prompt di seluruh penyedia.

OAuth dan autentikasi

Detail autentikasi dan aturan penggunaan ulang kredensial.