Skip to main content

​
openclaw setup

openclaw setup è il punto di ingresso dell’agente di sistema. In un sistema configurato, il semplice openclaw setup apre una chat interattiva di OpenClaw. In un sistema nuovo, passa all’onboarding guidato. Usare -m/--message per una singola richiesta oppure --baseline per inizializzare le cartelle di configurazione/area di lavoro senza la procedura guidata. Ordine di instradamento:
  1. Qualsiasi opzione di onboarding (--wizard, --baseline, area di lavoro, reimpostazione, modalità non interattiva, flusso, modalità, Gateway, demone, salto, importazione, remoto oppure opzioni di autenticazione) esegue l’onboarding esattamente come openclaw onboard.
  2. -m/--message oppure --yes esegue l’agente di sistema.
  3. Senza opzioni di instradamento, un sistema interattivo configurato apre OpenClaw. Un sistema nuovo esegue l’onboarding. In un sistema configurato, --json stampa la panoramica del sistema anche senza TTY; un’opzione di onboarding mantiene il riepilogo JSON dell’onboarding.
In modalità guidata, --workspace <dir> è l’area di lavoro proposta a OpenClaw; viene salvata solo dopo l’approvazione della proposta. Le configurazioni di base, classica e non interattiva salvano l’area di lavoro fornita attraverso il rispettivo flusso normale. Il rilevamento guidato dell’inferenza viene eseguito sull’host del Gateway su macOS o Linux. La CLI e l’app macOS chiamano lo stesso rilevatore gestito dal Gateway, che verifica i modelli configurati, gli accessi CLI supportati, le variabili di ambiente delle chiavi API e i modelli Ollama o LM Studio già installati. I modelli locali non vengono mai scaricati durante questo passaggio automatico; il candidato selezionato deve rispondere a un completamento reale prima che la configurazione del provider e del modello venga salvata. setup accetta gli stessi flag di onboarding di openclaw onboard, inclusi quelli di autenticazione (--auth-choice, --token, flag delle chiavi del provider), Gateway (--gateway-port, --gateway-bind, --gateway-auth, --install-daemon), Tailscale (--tailscale), reimpostazione (--reset, --reset-scope), flusso (--flow quickstart|advanced|manual|import) e i flag di salto (--skip-channels, --skip-skills, --skip-bootstrap, --skip-search, --skip-health, --skip-ui, --skip-hooks). Consultare Onboarding e Automazione della CLI per il riferimento completo dei flag e gli esempi non interattivi. openclaw onboard --modern rimane una voce di compatibilità per lo stesso assistente OpenClaw subordinato al rilevamento dell’inferenza.
openclaw setup è destinato alle installazioni con configurazione modificabile. In modalità Nix (OPENCLAW_NIX_MODE=1) OpenClaw rifiuta le scritture di configurazione perché il file di configurazione è gestito da Nix. Usare la Guida rapida di nix-openclaw ufficiale oppure la configurazione sorgente equivalente per un altro pacchetto Nix.

​
Opzioni

--classic e --non-interactive si escludono a vicenda: la modalità classica apre la procedura guidata con richieste, mentre la configurazione non interattiva usa il percorso di automazione.

​
Modalità di base

openclaw setup --baseline mantiene il precedente comportamento limitato alla configurazione di base: crea le directory di configurazione, dell’area di lavoro e delle sessioni, quindi termina senza eseguire l’onboarding.

​
Esempi

​
Note

  • Dopo la configurazione di base, eseguire openclaw onboard per il percorso guidato completo, openclaw configure per modifiche mirate oppure openclaw channels add per aggiungere account di canale.
  • Se viene rilevato lo stato di Hermes, l’onboarding interattivo può proporre automaticamente la migrazione. L’onboarding di importazione richiede una nuova configurazione; usare Migrazione per piani di simulazione, backup e modalità di sovrascrittura al di fuori dell’onboarding.

​
Contenuti correlati