Vai al contenuto principale

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 configure

Prompt interattivo per modifiche mirate a una configurazione esistente: credenziali, dispositivi, impostazioni predefinite degli agenti, Gateway, canali, plugin, Skills e controlli di integrità. Usa openclaw onboard per il percorso completo guidato di primo avvio, openclaw setup solo per la configurazione/area di lavoro di base e openclaw channels add quando ti serve soltanto configurare l’account del canale.
La sezione Model include una selezione multipla per la allowlist agents.defaults.models (ciò che viene visualizzato in /model e nel selettore di modelli). Le scelte di configurazione con ambito provider uniscono i modelli selezionati alla allowlist esistente invece di sostituire provider non correlati già presenti nella configurazione.La riesecuzione dell’autenticazione del provider da configure conserva un agents.defaults.model.primary esistente, anche quando il passaggio di autenticazione del provider restituisce una patch di configurazione con il proprio modello predefinito consigliato. Ciò significa che aggiungere o riautenticare xAI, OpenRouter o un altro provider dovrebbe rendere disponibile il nuovo modello senza sostituire il tuo modello primario corrente. Usa openclaw models auth login --provider <id> --set-default o openclaw models set <model> quando vuoi intenzionalmente cambiare il modello predefinito.
Quando configure viene avviato da una scelta di autenticazione del provider, i selettori del modello predefinito e della allowlist preferiscono automaticamente quel provider. Per provider accoppiati come Volcengine e BytePlus, la stessa preferenza corrisponde anche alle loro varianti di piano di codifica (volcengine-plan/*, byteplus-plan/*). Se il filtro del provider preferito producesse un elenco vuoto, configure ripiega sul catalogo non filtrato invece di mostrare un selettore vuoto.
openclaw config senza un sottocomando apre la stessa procedura guidata. Usa openclaw config get|set|unset per modifiche non interattive.
Per la ricerca web, openclaw configure --section web ti consente di scegliere un provider e configurarne le credenziali. Alcuni provider mostrano anche prompt successivi specifici del provider:
  • Grok può offrire la configurazione facoltativa di x_search con la stessa XAI_API_KEY e consentirti di scegliere un modello x_search.
  • Kimi può chiedere l’area dell’API Moonshot (api.moonshot.ai rispetto a api.moonshot.cn) e il modello di ricerca web Kimi predefinito.
Correlati:

Opzioni

  • --section <section>: filtro di sezione ripetibile
Sezioni disponibili:
  • workspace
  • model
  • web
  • gateway
  • daemon
  • channels
  • plugins
  • skills
  • health
Note:
  • La scelta di dove viene eseguito il Gateway aggiorna sempre gateway.mode. Puoi selezionare “Continua” senza altre sezioni se è tutto ciò che ti serve.
  • Dopo le scritture della configurazione locale, configure installa i plugin scaricabili selezionati quando il percorso di configurazione scelto li richiede. La configurazione del Gateway remoto non installa pacchetti plugin locali.
  • I servizi orientati ai canali (Slack/Discord/Matrix/Microsoft Teams) richiedono allowlist di canali/stanze durante la configurazione. Puoi inserire nomi o ID; la procedura guidata risolve i nomi in ID quando possibile.
  • Se esegui il passaggio di installazione del daemon, l’autenticazione con token richiede un token e gateway.auth.token è gestito da SecretRef, configure convalida il SecretRef ma non persiste i valori del token in chiaro risolti nei metadati dell’ambiente del servizio supervisor.
  • Se l’autenticazione con token richiede un token e il SecretRef del token configurato non è risolto, configure blocca l’installazione del daemon con indicazioni di correzione utilizzabili.
  • Se sia gateway.auth.token sia gateway.auth.password sono configurati e gateway.auth.mode non è impostato, configure blocca l’installazione del daemon finché la modalità non viene impostata esplicitamente.

Esempi

openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon

Correlati