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 + modelli: Modelli
• Concetti di selezione del modello + comando slash /models: Concetto di modelli
• Configurazione dell’autenticazione del provider: Per iniziare

​

Comandi comuni

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

• models set <model-or-alias> accetta provider/model o un alias.
• models list è di sola lettura: legge configurazione, profili di autenticazione, stato del catalogo esistente e righe del catalogo di proprietà del provider, ma non riscrive models.json.
• La colonna Auth è a livello di provider ed è di sola lettura. È calcolata dai metadati dei profili di autenticazione locali, marker env, chiavi provider configurate, marker di provider locali, marker env/profilo AWS Bedrock e metadati di autenticazione sintetica dei plugin; non carica il runtime del provider, non legge segreti dal portachiavi, non chiama API del provider e non dimostra l’esatta prontezza di esecuzione per modello.
• models list --all --provider <id> può includere righe di catalogo statico di proprietà del provider da manifest dei plugin o metadati del catalogo provider incluso anche quando non ti sei ancora autenticato con quel provider. Quelle righe risultano comunque non disponibili finché non viene configurata l’autenticazione corrispondente.
• models list mantiene il piano di controllo reattivo mentre la scoperta del catalogo provider è lenta. Le viste predefinite e configurate ripiegano su righe modello configurate o sintetiche dopo una breve attesa e lasciano che la scoperta finisca in background. Usa --all quando hai bisogno del catalogo completo scoperto esatto e sei disposto ad attendere la scoperta del provider.
• models list --all ad ampio raggio fonde le righe del catalogo manifest sopra le righe del registro senza caricare gli hook supplementari del runtime del provider. I percorsi rapidi del manifest filtrati per provider usano solo provider marcati static; i provider marcati refreshable restano basati su registro/cache e aggiungono righe manifest come supplementi, mentre i provider marcati runtime restano su scoperta registro/runtime.
• models list mantiene distinti i metadati nativi del modello e i limiti del runtime. Nell’output tabellare, Ctx mostra contextTokens/contextWindow quando un limite di runtime effettivo differisce dalla finestra di contesto nativa; le righe JSON includono contextTokens quando un provider espone quel limite.
• models list --provider <id> filtra per id provider, ad esempio moonshot o openai-codex. Non accetta etichette visualizzate dai selettori provider interattivi, come Moonshot AI.
• I riferimenti modello vengono analizzati dividendo sulla prima /. Se l’ID modello include / (stile OpenRouter), includi il prefisso del provider (esempio: openrouter/moonshotai/kimi-k2).
• Se ometti il provider, OpenClaw risolve l’input prima come alias, poi come corrispondenza univoca di provider configurato per quell’id modello esatto, e solo dopo ripiega sul provider predefinito configurato con un avviso di deprecazione. Se quel provider non espone più il modello predefinito configurato, OpenClaw ripiega sul primo provider/modello configurato invece di mostrare un predefinito obsoleto di provider rimosso.
• models status può mostrare marker(<value>) nell’output di autenticazione per placeholder non segreti (ad esempio OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) invece di mascherarli come segreti.

​

Scansione dei modelli

• --no-probe (solo metadati; nessuna ricerca di config/segreti)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (timeout della richiesta catalogo e per probe)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

Stato dei modelli

• --json
• --plain
• --check (codice di uscita 1=scaduto/mancante, 2=in scadenza)
• --probe (probe live dei profili di autenticazione configurati)
• --probe-provider <name> (esegue il probe di un provider)
• --probe-profile <id> (id profilo ripetuti o separati da virgole)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (id agent configurato; sovrascrive OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

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

• excluded_by_auth_order: esiste un profilo salvato, ma auth.order.<provider> esplicito lo ha omesso, quindi il probe segnala l’esclusione invece di provarlo.
• missing_credential, invalid_expires, expired, unresolved_ref: il profilo è presente ma non è idoneo/risolvibile.
• no_model: l’autenticazione del provider esiste, ma OpenClaw non è riuscito a risolvere un candidato modello verificabile per quel provider.

​

Alias + fallback

openclaw models aliases list
openclaw models fallbacks list

​

Profili di autenticazione

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 e paste-token restano comandi token generici per i provider che espongono metodi di autenticazione tramite token.
• setup-token richiede una TTY interattiva ed esegue il metodo di autenticazione tramite token del provider (predefinito al metodo setup-token di quel provider quando ne espone uno).
• paste-token accetta una stringa token generata altrove o dall’automazione.
• paste-token richiede --provider, chiede il valore del token e lo scrive nell’id profilo predefinito <provider>:manual a meno che tu non passi --profile-id.
• paste-token --expires-in <duration> archivia una scadenza assoluta del token da una durata relativa come 365d o 12h.
• Nota Anthropic: lo staff Anthropic ci ha detto che l’uso in stile OpenClaw della Claude CLI è di nuovo consentito, quindi OpenClaw considera il riuso della Claude CLI e l’uso di claude -p autorizzati per questa integrazione a meno che Anthropic non pubblichi una nuova policy.
• setup-token / paste-token di Anthropic restano disponibili come percorso token OpenClaw supportato, ma OpenClaw ora preferisce il riuso della Claude CLI e claude -p quando disponibili.

​

Correlati

• Riferimento CLI
• Selezione del modello
• Failover del modello