Vai al contenuto principale

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.
La sezione Modello include una selezione multipla per l’allowlist agents.defaults.models (ciò che viene mostrato in /model e nel selettore dei modelli). Le scelte di configurazione con ambito provider uniscono i modelli selezionati all’allowlist esistente invece di sostituire i provider non correlati già presenti nella configurazione.Rieseguire l’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. Questo significa che aggiungere o riautenticare xAI, OpenRouter o un altro provider dovrebbe rendere disponibile il nuovo modello senza sostituire il modello primario corrente. Usa openclaw models auth login --provider <id> --set-default o openclaw models set <model> quando vuoi cambiare intenzionalmente il modello predefinito.
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.
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 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:

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 configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon

Correlati