Vai al contenuto principale

​
Automazione CLI

Usa --non-interactive per automatizzare openclaw onboard.
--json non implica la modalità non interattiva. Usa --non-interactive (e --workspace) per gli script.

​
Esempio base non interattivo

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills
Aggiungi --json per un riepilogo leggibile da una macchina. Usa --secret-input-mode ref per archiviare riferimenti basati su variabili d’ambiente nei profili di autenticazione invece di valori in chiaro. La selezione interattiva tra riferimenti env e riferimenti provider configurati (file o exec) è disponibile nel flusso di onboarding. In modalità ref non interattiva, le variabili d’ambiente del provider devono essere impostate nell’ambiente del processo. Il passaggio di flag inline per le chiavi senza la corrispondente variabile d’ambiente ora fallisce immediatamente. Esempio: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

​
Esempi specifici per provider

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice anthropic-cli \
  --gateway-port 18789 \
  --gateway-bind loopback
Richiede che Claude CLI sia già installata e che l’accesso sia già stato effettuato sullo stesso host Gateway.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Sostituisci con --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" per il catalogo Go.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --gateway-port 18789 \
  --gateway-bind loopback
--custom-api-key è facoltativo. Se omesso, l’onboarding controlla CUSTOM_API_KEY.Variante in modalità ref:
export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --secret-input-mode ref \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --gateway-port 18789 \
  --gateway-bind loopback
In questa modalità, l’onboarding archivia apiKey come { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
Anthropic setup-token è di nuovo disponibile come percorso legacy/manuale per l’onboarding. Usalo sapendo che Anthropic ha comunicato agli utenti di OpenClaw che il percorso di accesso Claude di OpenClaw richiede Extra Usage. Per l’uso in produzione, preferisci una chiave API Anthropic.

​
Aggiungere un altro agente

Usa openclaw agents add <name> per creare un agente separato con il proprio workspace, sessioni e profili di autenticazione. L’esecuzione senza --workspace avvia la procedura guidata. 
openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.4 \
  --bind whatsapp:biz \
  --non-interactive \
  --json
Cosa imposta:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Note:
  • I workspace predefiniti seguono ~/.openclaw/workspace-<agentId>.
  • Aggiungi bindings per instradare i messaggi in ingresso (la procedura guidata può farlo).
  • Flag non interattive: --model, --agent-dir, --bind, --non-interactive.

​
Documentazione correlata