​

Anthropic (Claude)

​

Opsi A: API key Anthropic

​

Setup CLI

openclaw onboard
# pilih: Anthropic API key

# atau non-interaktif
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Cuplikan konfigurasi Claude CLI

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

Default thinking (Claude 4.6)

• Model Anthropic Claude 4.6 menggunakan default thinking adaptive di OpenClaw ketika tidak ada level thinking eksplisit yang disetel.
• Anda dapat mengoverride per pesan (/think:<level>) atau di parameter model: agents.defaults.models["anthropic/<model>"].params.thinking.
• Dokumentasi Anthropic terkait:
  • Adaptive thinking
  • Extended thinking

​

Mode cepat (Anthropic API)

• /fast on dipetakan ke service_tier: "auto"
• /fast off dipetakan ke service_tier: "standard_only"
• Default konfigurasi:

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

• OpenClaw hanya menyisipkan service tier Anthropic untuk permintaan langsung ke api.anthropic.com. Jika Anda merutekan anthropic/* melalui proxy atau gateway, /fast membiarkan service_tier tetap tidak tersentuh.
• Parameter model serviceTier atau service_tier Anthropic yang eksplisit mengoverride default /fast ketika keduanya disetel.
• Anthropic melaporkan tier efektif pada respons di bawah usage.service_tier. Pada akun tanpa kapasitas Priority Tier, service_tier: "auto" tetap dapat ter-resolve menjadi standard.

​

Prompt caching (Anthropic API)

​

Konfigurasi

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

​

Default

​

Override cacheRetention per agen

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline untuk sebagian besar agen
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override hanya untuk agen ini
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (id yang cocok, override per key)

​

Catatan Claude di Bedrock

• Model Anthropic Claude di Bedrock (amazon-bedrock/*anthropic.claude*) menerima pass-through cacheRetention saat dikonfigurasi.
• Model Bedrock non-Anthropic dipaksa menjadi cacheRetention: "none" saat runtime.
• Default cerdas Anthropic API-key juga menginisialisasi cacheRetention: "short" untuk ref model Claude-on-Bedrock saat tidak ada nilai eksplisit yang disetel.

​

Jendela konteks 1M (beta Anthropic)

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

​

Opsi B: Claude CLI sebagai penyedia pesan

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw meluncurkan claude -p --output-format stream-json --include-partial-messages ... pada host gateway dan mengirim prompt melalui stdin.
2. Giliran pertama mengirim --session-id <uuid>.
3. Giliran lanjutan menggunakan kembali sesi Claude yang tersimpan melalui --resume <sessionId>.
4. Pesan obrolan Anda tetap melalui pipeline pesan OpenClaw normal, tetapi balasan model yang sebenarnya dihasilkan oleh Claude CLI.

​

Persyaratan

• Claude CLI terinstal di host gateway dan tersedia di PATH, atau dikonfigurasi dengan path command absolut.
• Claude CLI sudah terautentikasi pada host yang sama:

claude auth status

• OpenClaw memuat otomatis plugin Anthropic bawaan saat startup gateway ketika konfigurasi Anda secara eksplisit mereferensikan claude-cli/... atau konfigurasi backend claude-cli.

​

Cuplikan konfigurasi

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Yang Anda dapatkan

• Auth langganan Claude digunakan kembali dari CLI lokal (dibaca saat runtime, tidak dipersistenkan)
• Routing pesan/sesi OpenClaw normal
• Kontinuitas sesi Claude CLI antar giliran (dibatalkan saat auth berubah)
• Tool gateway diekspos ke Claude CLI melalui bridge MCP loopback
• Streaming JSONL dengan progres partial-message langsung

​

Migrasi dari auth Anthropic ke Claude CLI

• Claude CLI terinstal pada host gateway yang sama yang menjalankan OpenClaw
• Claude CLI sudah login di sana: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• memverifikasi bahwa Claude CLI sudah login di host gateway
• mengganti model default ke claude-cli/...
• menulis ulang fallback model default Anthropic seperti anthropic/claude-opus-4-6 menjadi claude-cli/claude-opus-4-6
• menambahkan entri claude-cli/... yang sesuai ke agents.defaults.models

openclaw models status

• menghapus profil auth Anthropic yang sudah ada
• menghapus setiap ref konfigurasi anthropic/... lama di luar jalur model default/allowlist utama

​

Batas penting

• Ini bukan penyedia Anthropic API. Ini adalah runtime CLI lokal.
• OpenClaw tidak menyisipkan tool call secara langsung. Claude CLI menerima tool gateway melalui bridge MCP loopback (bundleMcp: true, default).
• Claude CLI men-stream balasan melalui JSONL (stream-json dengan --include-partial-messages). Prompt dikirim melalui stdin, bukan argv.
• Auth dibaca saat runtime dari kredensial Claude CLI aktif dan tidak dipersistenkan ke profil OpenClaw. Prompt Keychain ditekan dalam konteks non-interaktif.
• Penggunaan ulang sesi dilacak melalui metadata cliSessionBinding. Saat status login Claude CLI berubah (login ulang, rotasi token), sesi yang tersimpan dibatalkan dan sesi baru dimulai.
• Paling cocok untuk host gateway pribadi, bukan setup penagihan multi-pengguna bersama.

​

Catatan

• Dokumentasi publik Claude Code milik Anthropic masih mendokumentasikan penggunaan CLI langsung seperti claude -p. Kami yakin fallback lokal yang dikelola pengguna kemungkinan diizinkan, tetapi pemberitahuan terpisah Anthropic kepada pengguna OpenClaw menyatakan jalur login Claude milik OpenClaw adalah penggunaan third-party harness dan memerlukan Extra Usage (pay-as-you-go yang ditagihkan terpisah dari langganan). Untuk produksi, kami merekomendasikan API key Anthropic sebagai gantinya.
• Setup-token Anthropic tersedia lagi di OpenClaw sebagai jalur lama/manual. Pemberitahuan penagihan Anthropic khusus OpenClaw tetap berlaku, jadi gunakan dengan ekspektasi bahwa Anthropic memerlukan Extra Usage untuk jalur ini.
• Detail auth + aturan penggunaan ulang ada di /concepts/oauth.

​

Pemecahan masalah

• Auth token Anthropic lama dapat kedaluwarsa atau dicabut.
• Untuk setup baru, migrasikan ke API key Anthropic atau jalur Claude CLI lokal pada host gateway.

• Auth bersifat per agen. Agen baru tidak mewarisi key agen utama.
• Jalankan ulang onboarding untuk agen tersebut, atau konfigurasikan API key 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 API key atau Claude CLI untuk jalur profil tersebut.

• Periksa openclaw models status --json untuk auth.unusableProfiles.
• Cooldown rate-limit Anthropic dapat dicakup per model, sehingga model Anthropic sibling mungkin masih dapat digunakan meskipun model saat ini sedang cooldown.
• Tambahkan profil Anthropic lain atau tunggu cooldown selesai.