OpenClawDocs
Sur cette page

Sur cette page

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Setup guides and reference

Automatisation de la CLI

Utilisez openclaw onboard --non-interactive pour automatiser la configuration. Cette commande nécessite --accept-risk : la configuration non interactive peut écrire des identifiants et la configuration du démon sans demander de confirmation ; cette option constitue donc l’acceptation explicite du risque.

Exemple non interactif de référence

bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --secret-input-mode plaintext \  --gateway-bind loopback \  --install-daemon \  --daemon-runtime node \  --skip-bootstrap \  --skip-skills

Ajoutez --json pour obtenir un récapitulatif lisible par une machine.

  • --gateway-port utilise par défaut 18789 ; transmettez cette option uniquement pour remplacer cette valeur.
  • --skip-bootstrap évite de créer les fichiers d’espace de travail par défaut, pour les automatisations qui préremplissent leur propre espace de travail.
  • --secret-input-mode ref stocke dans le profil d’authentification une référence reposant sur une variable d’environnement ({ source: "env", provider: "default", id: "<ENV_VAR>" }) au lieu de la clé en texte brut. En mode ref non interactif, la variable d’environnement du fournisseur doit déjà être définie dans l’environnement du processus : transmettre une option de clé en ligne sans la variable d’environnement correspondante provoque un échec immédiat.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Exemples propres aux fournisseurs

Exemple avec une clé d’API Anthropic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Exemple avec Cloudflare AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback
Exemple avec Gemini
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Exemple avec Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Exemple avec Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Exemple avec Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
Exemple avec OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

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

Exemple avec Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Exemple avec Vercel AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \  --gateway-bind loopback
Exemple avec Z.AI
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
Exemple avec un fournisseur personnalisé
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

--custom-api-key est facultative ; certains points de terminaison ne nécessitent pas d’authentification. Si elle est omise, l’intégration initiale recherche CUSTOM_API_KEY dans l’environnement. --custom-provider-id est facultative et, si elle est omise, sa valeur est automatiquement dérivée de l’URL de base. La valeur par défaut de --custom-compatibility est openai (autres valeurs : openai-responses, anthropic).

OpenClaw déduit la prise en charge des images en entrée à partir de motifs connus d’identifiants de modèles de vision (gpt-4o, claude-3/4, gemini, suffixes -vl/vision et similaires). Ajoutez --custom-image-input pour l’activer de force avec un modèle de vision non reconnu, ou --custom-text-input pour imposer les entrées textuelles uniquement.

Variante en mode référence, qui stocke apiKey sous la forme { source: "env", provider: "default", id: "CUSTOM_API_KEY" } :

bash
export CUSTOM_API_KEY="your-key"openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

L’authentification par jeton de configuration Anthropic reste prise en charge, mais OpenClaw privilégie la réutilisation de la CLI Claude lorsqu’une connexion locale à celle-ci est disponible. En production, privilégiez une clé d’API Anthropic.

Ajouter un autre agent

openclaw agents add <name> crée un agent distinct disposant de ses propres espace de travail, sessions et profils d’authentification. L’exécuter sans --workspace ni aucune autre option lance l’assistant interactif ; transmettre l’une des options --workspace, --model, --agent-dir, --bind ou --non-interactive l’exécute en mode non interactif et impose alors --workspace.

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

Clés de configuration écrites par la commande (entrée agents.list[] correspondant au nouvel identifiant d’agent) :

  • name
  • workspace
  • agentDir
  • model (uniquement lorsque --model est transmise)

Remarques :

  • Espace de travail par défaut lorsque --workspace est omise dans l’assistant interactif : ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> peut être répétée ; ajoutez des liaisons pour acheminer les messages entrants vers le nouvel agent (l’assistant permet également de le faire de manière interactive).
  • Le nom de l’agent est normalisé afin de produire un identifiant d’agent valide ; main est réservé.

Documentation associée

Was this useful?