# openclaw configure

Prompt interattivo per configurare credenziali, dispositivi e impostazioni predefinite degli agenti.

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 associati come Volcengine e BytePlus, la stessa preferenza corrisponde anche alle loro varianti coding-plan (volcengine-plan/*, byteplus-plan/*). Se il filtro del provider preferito produrrebbe un elenco vuoto, configure ripiega sul catalogo non filtrato invece di mostrare un selettore vuoto.

Per la ricerca web, openclaw configure --section web ti consente di scegliere un provider e configurarne le credenziali. Alcuni provider mostrano anche prompt di follow-up 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 la regione dell'API Moonshot (api.moonshot.ai rispetto a api.moonshot.cn) e il modello predefinito di ricerca web Kimi.

Correlati:

• Riferimento configurazione Gateway: Configurazione
• CLI di configurazione: Config

# Opzioni

• --section <section>: filtro di sezione ripetibile

Sezioni disponibili:

• workspace
• model
• web
• gateway
• daemon
• channels
• plugins
• skills
• health

Note:

• Scegliere dove viene eseguito il Gateway aggiorna sempre gateway.mode. Puoi selezionare "Continua" senza altre sezioni se è tutto ciò di cui hai bisogno.
• 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 tramite token richiede un token e gateway.auth.token è gestito da SecretRef, configure convalida il SecretRef ma non rende persistenti i valori del token in testo semplice risolti nei metadati dell'ambiente del servizio supervisor.
• Se l'autenticazione tramite 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

• Riferimento CLI
• Configurazione