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.

​

openclaw models

• Provider + model: Model
• Konsep pemilihan model + perintah garis miring /models: Konsep model
• Penyiapan auth provider: Memulai

​

Perintah umum

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

• models set <model-or-alias> menerima provider/model atau alias.
• models list bersifat hanya-baca: perintah ini membaca config, profil auth, status katalog yang ada, dan baris katalog milik provider, tetapi tidak menulis ulang models.json.
• Kolom Auth berada di tingkat provider dan hanya-baca. Kolom ini dihitung dari metadata profil auth lokal, marker env, kunci provider yang dikonfigurasi, marker provider lokal, marker env/profil AWS Bedrock, dan metadata auth sintetis plugin; kolom ini tidak memuat runtime provider, membaca rahasia keychain, memanggil API provider, atau membuktikan kesiapan eksekusi tepat per model.
• models list --all --provider <id> dapat menyertakan baris katalog statis milik provider dari manifest plugin atau metadata katalog provider bawaan meskipun Anda belum mengautentikasi dengan provider tersebut. Baris tersebut tetap ditampilkan sebagai tidak tersedia sampai auth yang cocok dikonfigurasi.
• models list menjaga control plane tetap responsif saat penemuan katalog provider lambat. Tampilan default dan terkonfigurasi kembali ke baris model yang dikonfigurasi atau sintetis setelah penantian singkat dan membiarkan penemuan selesai di latar belakang. Gunakan --all saat Anda memerlukan katalog lengkap hasil penemuan yang persis dan bersedia menunggu penemuan provider.
• models list --all yang luas menggabungkan baris katalog manifest di atas baris registry tanpa memuat hook suplemen runtime provider. Jalur cepat manifest yang difilter provider hanya menggunakan provider yang ditandai static; provider yang ditandai refreshable tetap didukung registry/cache dan menambahkan baris manifest sebagai suplemen, sedangkan provider yang ditandai runtime tetap menggunakan penemuan registry/runtime.
• models list menjaga metadata model native dan batas runtime tetap terpisah. Dalam output tabel, Ctx menampilkan contextTokens/contextWindow saat batas runtime efektif berbeda dari jendela konteks native; baris JSON menyertakan contextTokens saat provider mengekspos batas tersebut.
• models list --provider <id> memfilter berdasarkan id provider, seperti moonshot atau openai-codex. Perintah ini tidak menerima label tampilan dari pemilih provider interaktif, seperti Moonshot AI.
• Ref model diuraikan dengan membagi pada / pertama. Jika ID model menyertakan / (gaya OpenRouter), sertakan prefiks provider (contoh: openrouter/moonshotai/kimi-k2).
• Jika Anda menghilangkan provider, OpenClaw me-resolve input sebagai alias terlebih dahulu, lalu sebagai kecocokan provider terkonfigurasi yang unik untuk id model persis tersebut, dan baru kemudian kembali ke provider default yang dikonfigurasi dengan peringatan deprekasi. Jika provider tersebut tidak lagi mengekspos model default yang dikonfigurasi, OpenClaw kembali ke provider/model terkonfigurasi pertama alih-alih menampilkan default provider yang sudah dihapus dan basi.
• models status dapat menampilkan marker(<value>) dalam output auth untuk placeholder non-rahasia (misalnya OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) alih-alih menyamarkannya sebagai rahasia.

​

Pemindaian model

• --no-probe (metadata saja; tanpa pencarian config/rahasia)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (permintaan katalog dan timeout per probe)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

Status model

• --json
• --plain
• --check (keluar 1=kedaluwarsa/hilang, 2=akan kedaluwarsa)
• --probe (probe langsung profil auth yang dikonfigurasi)
• --probe-provider <name> (probe satu provider)
• --probe-profile <id> (id profil berulang atau dipisahkan koma)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (id agen terkonfigurasi; menimpa OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

• excluded_by_auth_order: profil tersimpan ada, tetapi auth.order.<provider> eksplisit menghilangkannya, sehingga probe melaporkan pengecualian tersebut alih-alih mencobanya.
• missing_credential, invalid_expires, expired, unresolved_ref: profil ada tetapi tidak memenuhi syarat/dapat di-resolve.
• no_model: auth provider ada, tetapi OpenClaw tidak dapat me-resolve kandidat model yang dapat di-probe untuk provider tersebut.

​

Alias + fallback

openclaw models aliases list
openclaw models fallbacks list

​

Profil auth

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth list --provider openai

• setup-token dan paste-token tetap menjadi perintah token generik untuk provider yang mengekspos metode auth token.
• setup-token memerlukan TTY interaktif dan menjalankan metode auth token provider (default ke metode setup-token provider tersebut saat provider mengekspos metode itu).
• paste-token menerima string token yang dibuat di tempat lain atau dari otomatisasi.
• paste-token memerlukan --provider, meminta nilai token, dan menulisnya ke id profil default <provider>:manual kecuali Anda meneruskan --profile-id.
• paste-token --expires-in <duration> menyimpan kedaluwarsa token absolut dari durasi relatif seperti 365d atau 12h.
• Catatan Anthropic: staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI bergaya OpenClaw diizinkan kembali, sehingga OpenClaw memperlakukan penggunaan ulang Claude CLI dan penggunaan claude -p sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru.
• Anthropic setup-token / paste-token tetap tersedia sebagai jalur token OpenClaw yang didukung, tetapi OpenClaw sekarang lebih memilih penggunaan ulang Claude CLI dan claude -p saat tersedia.

​

Terkait

• Referensi CLI
• Pemilihan model
• Failover model