Autentikasi model OpenClaw

Dokumentasi membuka halaman ini dengan catatan cakupan yang layak diulang: halaman ini membahas autentikasi penyedia model, yaitu kunci API, OAuth, penggunaan ulang Claude CLI, dan setup token Anthropic, bukan token atau kata sandi yang melindungi koneksi Gateway. OpenClaw mendukung OAuth dan kunci API untuk penyedia, dan rekomendasinya jelas: untuk host Gateway yang selalu aktif, kunci API adalah opsi yang paling dapat diprediksi, sementara alur langganan dan OAuth berfungsi jika sesuai dengan akun penyedia Anda. Berikut penyiapan yang direkomendasikan, jalur Anthropic, tempat kredensial disimpan, cara memeriksanya, rotasi, dan cara memilih kredensial yang digunakan sebuah sesi.

Penyiapan yang direkomendasikan

• Buat kunci di konsol penyedia, ekspor kunci tersebut di host Gateway, yaitu mesin yang menjalankan Gateway, lalu periksa dengan perintah models status.
• Jika Gateway berjalan di bawah systemd atau launchd, taruh kunci di file env pada direktori state agar daemon dapat membacanya, mulai ulang, lalu periksa lagi dengan models status dan doctor; onboarding dapat menyimpan kunci untuk digunakan daemon jika Anda tidak ingin mengelola variabel.
• Penggunaan ulang Claude CLI adalah jalur Anthropic yang resmi diizinkan dan yang lebih disukai untuk penggunaan lokal atau desktop saat login Claude sudah ada di host: masuk ke Claude Code, lalu minta OpenClaw merutekan model Anthropic melalui backend Claude CLI lokal; OpenClaw tidak pernah membaca, menyimpan, memperbarui, atau meneruskan token login native, proses yang terinstal memperbarui login-nya sendiri, dan layanan harus dapat menemukan executable di path-nya.
• Setup token adalah jalur Anthropic lainnya: token berumur panjang yang dicetak oleh Claude Code di mesin mana pun, disimpan di host melalui perintah auth login dalam mode setup-token, yang memerlukan terminal interaktif.

Untuk host gateway yang selalu aktif, kunci API adalah opsi yang paling dapat diprediksi; alur langganan/OAuth juga berfungsi jika sesuai dengan model akun penyedia Anda.

Tempat kredensial disimpan

Entri token manual berfungsi untuk penyedia mana pun dan menulis ke penyimpanan autentikasi SQLite per agen, tempat OpenClaw membaca profil autentikasi; detail endpoint seperti base URL, jenis API, id model, header, dan timeout ditempatkan di konfigurasi penyedia, bukan di profil. Instalasi lama dengan file autentikasi JSON diimpor oleh doctor dengan cadangan bercap waktu, rute eksternal seperti mode Bedrock SDK adalah metadata konfigurasi, bukan kredensial, dan kredensial dapat berupa referensi rahasia untuk kunci dan token, kecuali bahwa profil mode OAuth menolaknya. Menghapus autentikasi yang tersimpan tidak mencabut kunci di sisi penyedia, dan menghapus autentikasi penyedia melalui control plane saat Gateway berjalan akan menghentikan eksekusi aktif pada penyedia tersebut dengan alasan berhenti auth-revoked, agar klien dapat menunjukkan mengapa eksekusi berhenti.

Memeriksa, merotasi, memilih

• Models status dan doctor adalah alat pemeriksanya; untuk otomatisasi, flag check keluar dengan kode satu saat kredensial kedaluwarsa atau tidak ada dan dua saat akan kedaluwarsa, dan flag probe menjalankan probe autentikasi langsung dengan flag pembatas cakupan, melaporkan profil yang dikecualikan oleh urutan autentikasi, penyedia yang memiliki autentikasi tetapi tidak memiliki model yang dapat di-probe, serta cooldown batas laju per model yang membiarkan model lain di penyedia yang sama tetap dapat digunakan.
• Beberapa penyedia mencoba ulang permintaan yang terkena batas laju dengan kunci alternatif yang dikonfigurasi, dalam prioritas tetap: satu kunci override live, daftar kunci yang dipisahkan pembatas, variabel kunci biasa, lalu varian berawalan apa pun, dengan penyedia Google juga beralih ke kunci Google generik; rotasi hanya dipicu oleh error batas laju, kuota, dan too-many-requests, sedangkan frasa throttling khusus penyedia menentukan klasifikasi failover yang terpisah.
• Profil kunci API OpenAI dan profil OAuth ChatGPT atau Codex sama-sama menggunakan id OpenAI kanonis, dan doctor menulis ulang id profil Codex lama dan entri urutan autentikasi. Beberapa login untuk satu penyedia tetap terpisah melalui id profil, flag force menghapus profil yang macet atau salah akun lalu menjalankan ulang alurnya, sebuah sesi menyematkan kredensial tertentu dengan perintah model dan akhiran profil, dan perintah auth-order per agen membaca (get), mengatur (set), dan menghapus (clear) pilihan otomatis.

OpenClaw dengan Claude dan OpenClaw dengan langganan ChatGPT adalah dua rute langganan yang dibedakan halaman ini dari kunci API.

Saat gagal

Pesan “No credentials found” berarti kunci tidak ada di host Gateway, atau jalur setup-token tidak pernah dijalankan, dan models status mengonfirmasi perbaikannya; token yang akan atau sudah kedaluwarsa ditampilkan di status yang sama, lalu diperbarui melalui setup token atau diganti dengan kunci API. Perintah new-session dan reset menghapus status fallback dan rotasi otomatis tetapi mempertahankan sematan profil eksplisit yang valid, dan mengubah urutan autentikasi hanya mengubah pemilihan otomatis. Failover model OpenClaw adalah mekanisme yang mengganti model atau penyedia saat terjadi kegagalan berulang, berbeda dari rotasi kunci, dan panduan rahasia OpenClaw menjelaskan sintaks referensi yang digunakan oleh referensi kunci dan token.

Di Diali

Di Diali, kunci yang Anda bawa disimpan di Vault dan konfigurasi yang kami buat mereferensikannya; tanpa kunci, asisten berjalan dengan kredit AI terkelola, dan dasbor menunjukkan mana yang sedang digunakan. Paket ChatGPT, SuperGrok, atau MiniMax yang sudah Anda bayar juga bisa menjalankannya: dasbor menampilkan kode sekali pakai, Anda menyetujuinya di halaman penyedia, dan asisten menyimpan sendiri proses masuknya, sehingga Diali tidak pernah memegang tokennya. Setup token Anthropic dan login lewat Claude CLI dinonaktifkan di Diali, karena ketentuan Anthropic tidak mengizinkan layanan yang di-hosting berjalan dengan langganan Claude; sebagai gantinya, gunakan kunci API Anthropic atau kredit terkelola. OpenClaw yang di-hosting di Diali adalah asistennya, dan panduan model dan penyedia OpenClaw membahas penyedia di balik kunci-kunci tersebut.

• Kunci API di host untuk Gateway yang selalu aktif.
• Profil autentikasi di SQLite, endpoint di konfigurasi.
• Rotasi saat terkena batas laju; failover untuk semua hal lainnya.