Riferimento per la configurazione della CLI

​

Funzioni della procedura guidata

• Configurazione del modello e dell’autenticazione (Anthropic, OAuth dell’abbonamento OpenAI Code, xAI, OpenCode, endpoint personalizzati e altri flussi di autenticazione gestiti dai provider)
• Posizione dello spazio di lavoro e file di bootstrap
• Impostazioni del Gateway (porta, binding, autenticazione, Tailscale)
• Canali e provider (Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp e altri canali inclusi o forniti tramite plugin)
• Provider di ricerca web (facoltativo)
• Installazione del daemon (LaunchAgent, unità utente systemd oppure attività pianificata nativa di Windows con ripiego sulla cartella Startup)
• Controllo di integrità
• Configurazione delle Skills

​

Dettagli del flusso locale

​

Dettagli della modalità remota

• URL del Gateway remoto (ws://... o wss://...)
• Token, password o nessuna autenticazione, in conformità con la configurazione del Gateway remoto

​

Opzioni di autenticazione e modello

• Selezionare il modello predefinito tra le opzioni rilevate oppure inserire manualmente provider e modello.
• Quando l’onboarding inizia dalla scelta dell’autenticazione di un provider, il selettore dei modelli preferisce automaticamente tale provider. Per Volcengine e BytePlus, la stessa preferenza corrisponde anche alle rispettive varianti del piano di coding (volcengine-plan/*, byteplus-plan/*).
• Se il filtro per il provider preferito non producesse risultati, il selettore ripiega sull’intero catalogo anziché non mostrare alcun modello.
• La procedura guidata esegue un controllo del modello e avvisa se il modello configurato è sconosciuto o privo di autenticazione.

• Profili di autenticazione (chiavi API + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Importazione OAuth precedente: ~/.openclaw/credentials/oauth.json

• Il comportamento predefinito dell’onboarding salva le chiavi API come valori in testo non crittografato nei profili di autenticazione.
• --secret-input-mode ref abilita la modalità di riferimento anziché la memorizzazione della chiave in testo non crittografato. Nella configurazione interattiva è possibile scegliere:
  • un riferimento a una variabile d’ambiente (ad esempio keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • un riferimento a un provider configurato (file o exec) con alias + ID del provider
• La modalità di riferimento interattiva esegue una rapida convalida preliminare prima del salvataggio.
  • Riferimenti a variabili d’ambiente: convalida il nome della variabile e la presenza di un valore non vuoto nell’ambiente di onboarding corrente.
  • Riferimenti ai provider: convalida la configurazione del provider e risolve l’ID richiesto.
  • Se la convalida preliminare non riesce, l’onboarding mostra l’errore e consente di riprovare.
• In modalità non interattiva, --secret-input-mode ref è supportato solo da una variabile d’ambiente.
  • Impostare la variabile d’ambiente del provider nell’ambiente del processo di onboarding.
  • I flag con chiave incorporata (ad esempio --openai-api-key) richiedono che tale variabile d’ambiente sia impostata; in caso contrario, l’onboarding non riesce immediatamente.
  • Per i provider personalizzati, la modalità non interattiva ref memorizza models.providers.<id>.apiKey come { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
  • In questo caso di provider personalizzato, --custom-api-key richiede che CUSTOM_API_KEY sia impostato; in caso contrario, l’onboarding non riesce immediatamente.
• Le credenziali di autenticazione del Gateway supportano le opzioni testo non crittografato e SecretRef nella configurazione interattiva:
  • Modalità token: Genera/memorizza token in testo non crittografato (valore predefinito) oppure Usa SecretRef.
  • Modalità password: testo non crittografato o SecretRef.
• Percorso SecretRef del token non interattivo: --gateway-token-ref-env <ENV_VAR>.
• Le configurazioni esistenti in testo non crittografato continuano a funzionare senza modifiche.

​

Output e dettagli interni

• agents.defaults.workspace
• agents.defaults.skipBootstrap quando viene passato --skip-bootstrap
• agents.defaults.model / models.providers (se viene scelto Minimax)
• tools.profile (l’onboarding locale usa per impostazione predefinita "coding" quando non è impostato; i valori espliciti esistenti vengono mantenuti)
• gateway.* (modalità, binding, autenticazione, Tailscale)
• session.dmScope (l’onboarding locale usa per impostazione predefinita per-channel-peer quando non è impostato; i valori espliciti esistenti vengono mantenuti)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• Elenchi di elementi consentiti dei canali (Discord, iMessage, Signal, Slack, Telegram, WhatsApp) quando si acconsente durante le richieste; Discord e Slack risolvono inoltre i nomi inseriti nei rispettivi ID
• skills.install.nodeManager
  • Il flag setup --node-manager accetta npm, pnpm o bun.
  • La configurazione manuale può comunque impostare skills.install.nodeManager: "yarn" in seguito.
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode
• wizard.securityAcknowledgedAt

​

Configurazione non interattiva

openclaw onboard --non-interactive --accept-risk \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY"

​

RPC della procedura guidata del Gateway

• wizard.start
• wizard.next
• wizard.cancel
• wizard.status

​

Comportamento della configurazione di Signal

• Scarica l’artefatto di rilascio appropriato dalle release GitHub ufficiali di signal-cli (build nativa, solo Linux x86-64)
• Sulle altre piattaforme (macOS, Linux non x64), esegue invece l’installazione tramite Homebrew
• Memorizza l’installazione dell’artefatto di rilascio in ~/.openclaw/tools/signal-cli/<version>/
• Scrive channels.signal.cliPath nella configurazione
• Windows nativo non è ancora supportato; eseguire l’onboarding in WSL2 per ottenere il percorso di installazione Linux

​

Documentazione correlata

• Hub dell’onboarding: Onboarding (CLI)
• Automazione e script: Automazione CLI
• Riferimento del comando: openclaw onboard