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.

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 kembali login Claude CLI yang sudah ada pada host yang sama
Staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI bergaya OpenClaw kembali diizinkan, sehingga OpenClaw memperlakukan penggunaan ulang Claude CLI dan penggunaan claude -p sebagai disetujui kecuali Anthropic menerbitkan kebijakan baru.Untuk host Gateway jangka panjang, kunci API Anthropic tetap menjadi jalur produksi yang paling jelas dan paling dapat diprediksi.Dokumentasi publik Anthropic saat ini:

Memulai

Paling cocok 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 berikan kunci secara langsung:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

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

Default thinking (Claude 4.6)

Model Claude 4.6 menggunakan thinking adaptive secara default di OpenClaw jika 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" },
        },
      },
    },
  },
}
Dokumentasi Anthropic terkait:

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 tingkat model sebagai baseline, 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, override berdasarkan kunci)
Ini memungkinkan satu agen mempertahankan cache berumur panjang sementara agen lain pada model yang sama menonaktifkan caching untuk traffic yang bursty/berpenggunaan 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 ref Claude-on-Bedrock saat tidak ada nilai eksplisit yang ditetapkan.

Konfigurasi lanjutan

Toggle /fast bersama OpenClaw mendukung traffic 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 diinjeksikan untuk permintaan langsung api.anthropic.com. Rute proxy membiarkan service_tier tidak berubah.
  • Parameter serviceTier atau service_tier eksplisit mengesampingkan /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 kapabilitas media secara otomatis dari autentikasi Anthropic yang dikonfigurasi — tidak diperlukan konfigurasi tambahan.
PropertiNilai
Model defaultclaude-opus-4-7
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 dikontrol oleh beta gate. 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 sesuai dengan perilaku API langsung.
Memerlukan akses konteks panjang pada kredensial Anthropic Anda. Auth token lama (sk-ant-oat-*) ditolak untuk permintaan konteks 1M — OpenClaw mencatat peringatan dan kembali ke jendela konteks standar.
anthropic/claude-opus-4.7 dan varian claude-cli-nya memiliki jendela konteks 1M secara default — tidak perlu params.context1m: true.

Pemecahan masalah

Auth token Anthropic kedaluwarsa dan dapat dicabut. Untuk penyiapan baru, gunakan kunci API Anthropic sebagai gantinya.
Auth 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 auth mana yang aktif. Jalankan ulang onboarding, atau konfigurasikan kunci API untuk path profil tersebut.
Periksa openclaw models status --json untuk auth.unusableProfiles. Cooldown rate-limit Anthropic dapat bersifat scoped per 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, ref model, dan perilaku failover.

Backend CLI

Detail penyiapan dan runtime backend Claude CLI.

Caching prompt

Cara kerja caching prompt lintas penyedia.

OAuth dan auth

Detail auth dan aturan penggunaan ulang kredensial.