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 o openclaw setup per il percorso completo guidato al primo avvio, openclaw setup --baseline solo per la configurazione/area di lavoro di base e openclaw channels add quando ti serve solo configurare un account di canale.

Quando configure parte da una scelta di autenticazione del provider, i selettori del modello predefinito e dell'allowlist preferiscono automaticamente quel provider. Per provider abbinati come Volcengine e BytePlus, la stessa preferenza corrisponde anche alle loro varianti di piano di coding (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 successivi specifici del provider:

• Grok può offrire la configurazione facoltativa di x_search con lo stesso profilo OAuth xAI o la stessa chiave API 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 Kimi predefinito per la ricerca web.

Correlati:

• Riferimento alla configurazione del 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:

• La procedura guidata completa e le sezioni relative al Gateway chiedono dove viene eseguito il Gateway e aggiornano gateway.mode. I filtri di sezione che non includono gateway, daemon o health passano direttamente alla configurazione richiesta.
• 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 di 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 mantiene i valori 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 operative per la correzione.
• 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 configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

Correlati

• Riferimento CLI
• Configurazione