Skip to main content
Usa openclaw onboard --non-interactive per automatizzare la configurazione tramite script. Richiede --accept-risk: la configurazione non interattiva può scrivere credenziali e la configurazione del demone senza una richiesta di conferma, quindi il flag costituisce l’accettazione esplicita del rischio.
--json non implica la modalità non interattiva. Per gli script, passa esplicitamente --non-interactive --accept-risk.

​
Esempio di base non interattivo

Aggiungi --json per ottenere un riepilogo leggibile dalla macchina.
  • Il valore predefinito di --gateway-port è 18789; passalo solo per sostituirlo.
  • --skip-bootstrap evita la creazione dei file predefiniti dell’area di lavoro, per le automazioni che precompilano la propria area di lavoro.
  • --secret-input-mode ref memorizza nel profilo di autenticazione un riferimento basato su una variabile di ambiente ({ source: "env", provider: "default", id: "<ENV_VAR>" }) anziché la chiave in testo normale. Nella modalità non interattiva ref, la variabile di ambiente del provider deve essere già impostata nell’ambiente del processo: il passaggio di un flag con una chiave inline senza la variabile di ambiente corrispondente causa un errore immediato.

​
Esempi specifici per provider

Per il catalogo Go, sostituisci con --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY".
--custom-api-key è facoltativo; alcuni endpoint non richiedono l’autenticazione. Se omesso, il processo di onboarding verifica la presenza di CUSTOM_API_KEY nell’ambiente. --custom-provider-id è facoltativo e, se omesso, viene derivato automaticamente dall’URL di base. Il valore predefinito di --custom-compatibility è openai (altri valori: openai-responses, anthropic).OpenClaw deduce il supporto per l’input di immagini dai modelli noti degli identificatori dei modelli di visione (gpt-4o, claude-3/4, gemini, suffissi -vl/vision e simili). Aggiungi --custom-image-input per abilitarlo forzatamente per un modello di visione non riconosciuto oppure --custom-text-input per imporre l’uso esclusivo del testo.Variante in modalità ref, che memorizza apiKey come { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:
L’autenticazione tramite token di configurazione Anthropic rimane supportata, ma OpenClaw preferisce riutilizzare Claude CLI quando è disponibile un accesso locale a Claude CLI. Per la produzione, preferisci una chiave API Anthropic.

​
Aggiungere un altro agente

openclaw agents add <name> crea un agente separato con la propria area di lavoro, le proprie sessioni e i propri profili di autenticazione. Eseguendolo senza --workspace (e senza altri flag) viene avviata la procedura guidata interattiva; il passaggio di uno qualsiasi tra --workspace, --model, --agent-dir, --bind o --non-interactive lo esegue in modalità non interattiva e richiede quindi --workspace.
Chiavi di configurazione scritte dal comando (voce agents.list[] per il nuovo identificatore dell’agente):
  • name
  • workspace
  • agentDir
  • model (solo quando viene passato --model)
Note:
  • Area di lavoro predefinita (quando --workspace viene omesso nella procedura guidata interattiva): ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> è ripetibile; aggiungi associazioni per instradare i messaggi in arrivo al nuovo agente (la procedura guidata consente di farlo anche in modo interattivo).
  • Il nome dell’agente viene normalizzato in un identificatore agente valido; main è riservato.

​
Documentazione correlata