Automatisation CLI

Utilisez --non-interactive pour automatiser openclaw onboard.

Exemple non interactif de base

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-bootstrap \
  --skip-skills

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

Utilisez --skip-bootstrap lorsque votre automation pré-remplit les fichiers de l’espace de travail et ne souhaite pas que l’onboarding crée les fichiers d’amorçage par défaut.

Utilisez --secret-input-mode ref pour stocker les refs soutenues par des env dans les profils d’auth au lieu des valeurs en clair. La sélection interactive entre les refs d’env et les refs de provider 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 drapeaux 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

Exemple de clé Anthropic API

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Exemple Gemini

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

Exemple Z.AI

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

Exemple Vercel IA Gateway

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

Exemple Gateway IA Cloudflare

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

Exemple Moonshot

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

Exemple Mistral

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

Exemple Synthetic

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

OuvrirExemple de code

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

Passez à --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" pour le catalogue Go.

Exemple Ollama

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

Exemple de provider personnalisé

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 \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

--custom-api-key est facultatif. S’il est omis, l’onboarding vérifie CUSTOM_API_KEY. OpenClaw marque automatiquement les ID de modèles de vision courants comme capables d’images. Ajoutez --custom-image-input pour les ID de vision personnalisés inconnus, ou --custom-text-input pour forcer les métadonnées texte uniquement.

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 \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

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

Le setup-token Anthropic reste disponible en tant que chemin de token d’onboarding pris en charge, mais OpenClaw préfère désormais la réutilisation du CLI Claude si disponible. Pour la production, préférez une clé Anthropic API.

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.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

Ce qu’il définit :

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

Remarques :

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

Documentation associée

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