Skip to main content

​
openclaw configure

Prompt interattivi per apportare modifiche mirate a una configurazione esistente: credenziali, dispositivi, valori predefiniti degli agenti, Gateway, canali, plugin, Skills e controlli di integrità. Usa openclaw onboard o openclaw setup per l’intera procedura guidata del primo avvio, openclaw setup --baseline solo per la configurazione e lo spazio di lavoro di base e openclaw channels add quando devi configurare soltanto l’account di un canale.
openclaw config senza sottocomandi apre la stessa procedura guidata. Usa openclaw config get|set|unset per le modifiche non interattive.

​
Opzioni

--section <section>: filtro ripetibile per sezione. Sezioni disponibili: workspace, model, web, gateway, daemon, channels, plugins, skills, health
Se selezioni gateway, daemon o health (oppure esegui l’intera procedura guidata senza --section), viene chiesto dove viene eseguito il Gateway e viene aggiornato gateway.mode. I filtri di sezione che escludono tutte e tre queste sezioni passano direttamente alla configurazione richiesta senza chiedere la modalità del Gateway. Se scegli la modalità Gateway remoto, la configurazione remota viene scritta e il programma termina immediatamente; non vengono eseguiti passaggi esclusivamente locali, come l’installazione dei plugin.
openclaw configure richiede un terminale interattivo (sia stdin sia stdout devono essere TTY). In assenza di un terminale interattivo, visualizza i comandii non interattivi equivalenti openclaw config get|set|patch|validate e termina con un errore, anziché eseguire solo una parte della procedura.

​
Sezione del modello

Modello include una selezione multipla per l’elenco consentito agents.defaults.models (ciò che appare in /model e nel selettore dei modelli). Le opzioni di configurazione specifiche del provider uniscono i modelli selezionati all’elenco consentito esistente, anziché sostituire i provider non correlati già presenti nella configurazione.Ripetere l’autenticazione del provider da configure preserva un valore agents.defaults.model.primary esistente, anche quando il passaggio di autenticazione del provider restituisce una patch di configurazione con un proprio modello predefinito consigliato. L’aggiunta o la nuova autenticazione di un provider rende disponibili i relativi modelli senza sostituire il modello primario corrente. Usa openclaw models auth login --provider <id> --set-default o openclaw models set <model> per cambiare intenzionalmente il modello predefinito.
Quando configure viene avviato da una scelta di autenticazione del provider, i selettori del modello predefinito e dell’elenco consentito danno automaticamente la priorità a tale provider. Per provider abbinati come Volcengine e BytePlus, la stessa preferenza corrisponde anche alle rispettive varianti del piano di programmazione (volcengine-plan/*, byteplus-plan/*). Se il filtro del provider preferito producesse un elenco vuoto, configure usa il catalogo non filtrato anziché mostrare un selettore vuoto.

​
Sezione Web

openclaw configure --section web seleziona un provider di ricerca sul Web e ne configura le credenziali. Alcuni provider mostrano passaggi successivi specifici:
  • Grok può offrire la configurazione facoltativa di x_search con lo stesso profilo OAuth xAI o la stessa chiave API e consentire di scegliere un modello x_search.
  • Kimi può chiedere la regione dell’API Moonshot (api.moonshot.ai oppure api.moonshot.cn) e il modello predefinito di Kimi per la ricerca sul Web.

​
Altre note

  • Dopo aver scritto la configurazione locale, configure installa i plugin scaricabili selezionati quando il percorso di configurazione scelto lo richiede. La configurazione del Gateway remoto non installa pacchetti di plugin locali.
  • Durante la configurazione, i servizi orientati ai canali (Slack/Discord/Matrix/Microsoft Teams) richiedono gli elenchi consentiti di canali/stanze. Puoi inserire nomi o ID; quando possibile, la procedura guidata converte i nomi in ID.
  • Se esegui il passaggio di installazione del daemon, l’autenticazione tramite token richiede un token. Se gateway.auth.token è gestito tramite SecretRef, configure convalida SecretRef ma non salva i valori risolti del token in testo semplice nei metadati dell’ambiente del servizio supervisore; se SecretRef non può essere risolto, configure blocca l’installazione del daemon e fornisce indicazioni operative per risolvere il problema.
  • Se sono configurati sia gateway.auth.token sia gateway.auth.password e gateway.auth.mode non è impostato, configure blocca l’installazione del daemon finché non imposti esplicitamente la modalità.

​
Argomenti correlati