Providers
Anthropic
Anthropic membangun keluarga model Claude. OpenClaw mendukung dua rute autentikasi:
- Kunci API — akses API Anthropic langsung dengan penagihan berbasis penggunaan (model
anthropic/*) - Claude CLI — gunakan ulang login Claude CLI yang sudah ada di host yang sama
Memulai
Kunci API
Paling cocok untuk: akses API standar dan penagihan berbasis penggunaan.
Dapatkan kunci API Anda
Buat kunci API di Anthropic Console.
Jalankan onboarding
openclaw onboard
# choose: Anthropic API key
Atau teruskan kunci secara langsung:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
Verifikasi bahwa model tersedia
openclaw models list --provider anthropic
Contoh konfigurasi
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
Paling cocok untuk: menggunakan ulang login Claude CLI yang sudah ada tanpa kunci API terpisah.
Pastikan Claude CLI sudah terpasang dan sudah login
Verifikasi dengan:
claude --version
Jalankan onboarding
openclaw onboard
# choose: Claude CLI
OpenClaw mendeteksi dan menggunakan ulang kredensial Claude CLI yang sudah ada.
Verifikasi bahwa model tersedia
openclaw models list --provider anthropic
Contoh konfigurasi
Utamakan ref model Anthropic kanonis ditambah override runtime CLI:
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
Ref model lama claude-cli/claude-opus-4-7 masih berfungsi untuk
kompatibilitas, tetapi konfigurasi baru sebaiknya mempertahankan pilihan provider/model sebagai
anthropic/* dan menaruh backend eksekusi di agentRuntime.id.
Default thinking (Claude 4.6)
Model Claude 4.6 secara default menggunakan thinking adaptive di OpenClaw ketika tidak ada level thinking eksplisit yang ditetapkan.
Override per pesan dengan /think:<level> atau di parameter model:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
Prompt caching
OpenClaw mendukung fitur prompt caching Anthropic untuk autentikasi kunci API.
| Nilai | Durasi cache | Deskripsi |
|---|---|---|
"short" (default) |
5 menit | Diterapkan otomatis untuk autentikasi kunci API |
"long" |
1 jam | Cache diperpanjang |
"none" |
Tanpa caching | Nonaktifkan prompt caching |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
Override cache per agen
Gunakan parameter tingkat 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:
agents.defaults.models["provider/model"].paramsagents.list[].params(idyang cocok, override berdasarkan kunci)
Ini memungkinkan satu agen mempertahankan cache berumur panjang sementara agen lain pada model yang sama menonaktifkan caching untuk lalu lintas bursty/berpenggunaan ulang rendah.
Catatan Bedrock Claude
- Model Anthropic Claude di Bedrock (
amazon-bedrock/*anthropic.claude*) menerima pass-throughcacheRetentionsaat dikonfigurasi. - Model Bedrock non-Anthropic dipaksa ke
cacheRetention: "none"saat runtime. - Default cerdas kunci API juga mengisi
cacheRetention: "short"untuk ref Claude-on-Bedrock saat tidak ada nilai eksplisit yang ditetapkan.
Konfigurasi lanjutan
Mode cepat
Toggle /fast bersama OpenClaw mendukung lalu lintas Anthropic langsung (kunci API dan OAuth ke api.anthropic.com).
| Perintah | Dipetakan ke |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
Pemahaman media (gambar dan PDF)
Plugin Anthropic bawaan mendaftarkan pemahaman gambar dan PDF. OpenClaw otomatis menyelesaikan kapabilitas media dari autentikasi Anthropic yang dikonfigurasi — tidak diperlukan konfigurasi tambahan.
| Properti | Nilai |
|---|---|
| Model default | claude-opus-4-7 |
| Input didukung | Gambar, dokumen PDF |
Saat gambar atau PDF dilampirkan ke percakapan, OpenClaw secara otomatis merutekannya melalui provider pemahaman media Anthropic.
Jendela konteks 1M (beta)
Jendela konteks 1M Anthropic dibatasi beta. Aktifkan per model:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
OpenClaw memetakan ini ke anthropic-beta: context-1m-2025-08-07 pada permintaan.
params.context1m: true juga berlaku untuk backend Claude CLI
(claude-cli/*) bagi model Opus dan Sonnet yang memenuhi syarat, memperluas jendela
konteks runtime untuk sesi CLI tersebut agar cocok dengan perilaku API langsung.
Konteks 1M Claude Opus 4.7
anthropic/claude-opus-4.7 dan varian claude-cli-nya memiliki jendela konteks 1M
secara default — tidak perlu params.context1m: true.
Pemecahan masalah
Error 401 / token tiba-tiba tidak valid
Autentikasi token Anthropic kedaluwarsa dan dapat dicabut. Untuk penyiapan baru, gunakan kunci API Anthropic sebagai gantinya.
Tidak ditemukan kunci API untuk provider "anthropic"
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.
Tidak ditemukan kredensial untuk profil "anthropic:default"
Jalankan openclaw models status untuk melihat profil autentikasi mana yang aktif. Jalankan ulang onboarding, atau konfigurasikan kunci API untuk jalur profil tersebut.
Tidak ada profil autentikasi yang tersedia (semua dalam cooldown)
Periksa openclaw models status --json untuk auth.unusableProfiles. Cooldown rate-limit Anthropic dapat bersifat per model, sehingga model Anthropic saudara mungkin masih dapat digunakan. Tambahkan profil Anthropic lain atau tunggu cooldown.