Anthropic

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

Memulai

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

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

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

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" },        },      },    },  },}

Fallback penolakan keselamatan (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.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  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" } },    ],  },}

Konfigurasi lanjutan

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

Pemecahan masalah

Terkait