> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configura

# `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.

<Note>
  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.
</Note>

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.

<Tip>
  `openclaw config` senza un sottocomando apre la stessa procedura guidata. Usa `openclaw config get|set|unset` per modifiche non interattive.
</Tip>

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](/it/gateway/configuration)
* CLI di configurazione: [Config](/it/cli/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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon
```

## Correlati

* [Riferimento CLI](/it/cli)
* [Configurazione](/it/gateway/configuration)