CLI Automation

CLI Automation

Utilisez --non-interactive pour automatiser openclaw onboard.

Note

--json

n’implique pas le mode non interactif. Utilisez

--non-interactive

(et

--workspace

) pour les scripts.

Exemple de base non interactif

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

Ajoutez --json pour un résumé lisible par machine.

Utilisez --secret-input-mode ref pour stocker les références basées sur des variables d’environnement dans les profils d’authentification au lieu des valeurs en texte clair. Une sélection interactive entre les références d’environnement et les références de fournisseur configurées (file ou exec) est disponible dans le flux d’onboarding.

En mode ref non interactif, les env vars de provider doivent être définies dans l’environnement du processus. Le passage de flags de clé en ligne sans la env var correspondante échoue désormais rapidement.

Exemple :

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

Exemples spécifiques au provider

Gemini example

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

Z.AI example

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

Vercel AI Gateway example

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

Cloudflare AI Gateway example

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

Moonshot example

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

Mistral example

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

Synthetic example

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

OpenCode example

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Remplacez par --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" pour le catalogue Go.

Ollama example

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback

Custom provider example

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 est optionnel. Si omis, l’onboarding vérifie CUSTOM_API_KEY.

Variante en mode 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

Dans ce mode, l’onboarding stocke apiKey sous la forme { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.

Ajouter un autre agent

Utilisez openclaw agents add <name> pour créer un agent distinct avec son propre espace de travail, sessions et profils d’authentification. L’exécution sans --workspace lance l’assistant.

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

Ce qu’il définit :

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

Notes :

• Les espaces de travail par défaut suivent ~/.openclaw/workspace-<agentId>.
• Ajoutez bindings pour router les messages entrants (l’assistant peut le faire).
• Indicateurs non interactifs : --model, --agent-dir, --bind, --non-interactive.

Documentation connexe

• Hub d’onboarding : Onboarding (CLI)
• Référence complète : CLI Setup Reference
• Référence de la commande : openclaw onboard