CLI commands
Configurazione
openclaw setup
openclaw setup esegue lo stesso flusso guidato di configurazione iniziale di openclaw onboard:
prima verifica e salva in modo persistente l'inferenza, quindi avvia Crestodian per configurare
lo spazio di lavoro, il Gateway, i canali, le Skills e lo stato di integrità. Usa --baseline quando
devi soltanto inizializzare le cartelle di configurazione e dello spazio di lavoro senza la procedura guidata.
In modalità guidata, --workspace <dir> è lo spazio di lavoro proposto a Crestodian;
viene salvato in modo persistente solo dopo l'approvazione della proposta. Le configurazioni di base, classica e
non interattiva salvano in modo persistente lo spazio di lavoro specificato tramite il rispettivo flusso normale.
setup accetta le stesse opzioni di configurazione iniziale di openclaw onboard, incluse
quelle per l'autenticazione (--auth-choice, --token, opzioni per le chiavi dei provider), il Gateway
(--gateway-port, --gateway-bind, --gateway-auth, --install-daemon),
Tailscale (--tailscale), il ripristino (--reset, --reset-scope), il flusso
(--flow quickstart|advanced|manual|import) e le opzioni per ignorare passaggi
(--skip-channels, --skip-skills, --skip-bootstrap, --skip-search,
--skip-health, --skip-ui, --skip-hooks). Consulta Configurazione iniziale e
Automazione della CLI per l'elenco completo delle opzioni e
gli esempi non interattivi. openclaw onboard --modern è l'alias di compatibilità
per l'assistente Crestodian subordinato alla verifica dell'inferenza e non ha un equivalente in setup.
Opzioni
| Opzione | Descrizione |
|---|---|
--workspace <dir> |
Proposta dello spazio di lavoro in modalità guidata; salvata direttamente dalla configurazione di base, classica e non interattiva. |
--baseline |
Crea le cartelle di base per configurazione, spazio di lavoro e sessioni senza la configurazione iniziale. |
--wizard |
Accettata per compatibilità; la configurazione esegue quella iniziale per impostazione predefinita. |
--non-interactive |
Esegue la configurazione iniziale senza richieste interattive. |
--accept-risk |
Conferma la consapevolezza del rischio di accesso dell'agente all'intero sistema; obbligatoria con --non-interactive. |
--mode <mode> |
Modalità di configurazione iniziale: local o remote. |
--flow <flow> |
Flusso di configurazione iniziale: quickstart, advanced, manual o import. |
--reset |
Reimposta configurazione, credenziali e sessioni prima della configurazione iniziale (lo spazio di lavoro solo con --reset-scope full). |
--reset-scope <scope> |
Ambito del ripristino: config, config+creds+sessions o full. |
--import-from <provider> |
Provider di migrazione da eseguire durante la configurazione iniziale. |
--import-source <path> |
Directory principale dell'agente sorgente per --import-from. |
--import-secrets |
Importa i segreti supportati durante la migrazione della configurazione iniziale. |
--remote-url <url> |
URL WebSocket del Gateway remoto. |
--remote-token <token> |
Token del Gateway remoto (facoltativo). |
--json |
Restituisce un riepilogo JSON. |
--classic e --non-interactive si escludono a vicenda: la modalità classica apre la
procedura guidata interattiva, mentre la configurazione non interattiva usa il percorso di automazione.
Modalità di base
openclaw setup --baseline conserva il precedente comportamento limitato alla configurazione di base:
crea le directory di configurazione, dello spazio di lavoro e delle sessioni, quindi termina senza
eseguire la configurazione iniziale.
Esempi
openclaw setupopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>Note
- Dopo la configurazione di base, esegui
openclaw setupoopenclaw onboardper completare l'intero percorso guidato,openclaw configureper modifiche mirate oppureopenclaw channels addper aggiungere account dei canali. - Se viene rilevato lo stato di Hermes, la configurazione iniziale interattiva può proporre automaticamente la migrazione. La configurazione iniziale mediante importazione richiede una nuova configurazione; usa Migrazione per piani di simulazione, backup e modalità di sovrascrittura al di fuori della configurazione iniziale.
