Skip to main content
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.
--json n’active pas implicitement le mode non interactif. Pour les scripts, transmettez explicitement --non-interactive --accept-risk.

​
Exemple non interactif de référence

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.

​
Exemples propres aux fournisseurs

Remplacez cette option par --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" pour utiliser le catalogue Go.
--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" } :
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.
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