Aller au contenu
OpenClaw Docs

Référence de la configuration CLI

Cette page constitue la référence complète pour openclaw onboard. Pour le guide court, consultez Onboarding (CLI).

Action de l’assistant

Section intitulée « Action de l’assistant »

Le mode local (par défaut) vous guide à travers :

  • Configuration du model et de l’authentification (abonnement Code OpenAI OAuth, Anthropic Claude CLI ou clé API, ainsi que les options MiniMax, GLM, Ollama, Moonshot, StepFun et AI Gateway)
  • Emplacement de l’espace de travail et fichiers d’amorçage
  • Paramètres du Gateway (port, liaison, authentification, tailscale)
  • Chaînes et fournisseurs (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, iMessage et autres plugins de chaîne inclus)
  • Installation du démon (LaunchAgent, unité utilisateur systemd ou tâche planifiée native Windows avec repli vers le dossier Démarrage)
  • Vérification de santé
  • Configuration des Skills

Le mode distant configure cette machine pour se connecter à une passerelle située ailleurs. Il n’installe ni ne modifie quoi que ce soit sur l’hôte distant.

Détails du flux local

Section intitulée « Détails du flux local »

  1. Détection de la configuration existante

    • Si ~/.openclaw/openclaw.json existe, choisissez Conserver, Modifier ou Réinitialiser.
    • Le fait de relancer l’assistant n’efface rien, sauf si vous choisissez explicitement Réinitialiser (ou si vous passez --reset).
    • L’option CLI --reset correspond par défaut à config+creds+sessions ; utilisez --reset-scope full pour supprimer également l’espace de travail.
    • Si la configuration n’est pas valide ou contient des clés héritées, l’assistant s’arrête et vous demande d’exécuter openclaw doctor avant de continuer.
    • La réinitialisation utilise trash et propose des portées :
      • Configuration uniquement
      • Configuration + identifiants + sessions
      • Réinitialisation complète (supprime également l’espace de travail)

  2. Modèle et auth

  3. Espace de travail

    • ~/.openclaw/workspace par défaut (configurable).
    • Initialise les fichiers de l’espace de travail nécessaires au rituel de démarrage initial.
    • Organisation de l’espace de travail : Agent workspace.

  4. Gateway

    • Demande le port, la liaison, le mode d’authentification et l’exposition Tailscale.
    • Recommandé : gardez l’authentification par jeton activée même pour le bouclage local afin que les clients WS locaux doivent s’authentifier.
    • En mode jeton, la configuration interactive propose :
      • Générer/stocker un jeton en texte brut (par défaut)
      • Utiliser SecretRef (optionnel)
    • En mode mot de passe, la configuration interactive prend également en charge le stockage en texte brut ou par SecretRef.
    • Chemin SecretRef du jeton non interactif : `—gateway-token-ref-env

    . - Nécessite une variable d'environnement non vide dans l'environnement du processus d'onboarding. - Ne peut pas être combiné avec —gateway-token`. - Désactivez l’authentification uniquement si vous faites pleinement confiance à chaque processus local. - Les liaisons non bouclage local nécessitent toujours une authentification.

  5. Canaux

    • WhatsApp : connexion QR facultative
    • Telegram : jeton de bot
    • Discord : jeton de bot
    • Google Chat : JSON de compte de service + audience webhook
    • Mattermost : jeton de bot + URL de base
    • Signal : installation facultative de signal-cli + configuration du compte
    • iMessage : chemin du imsg CLI + accès à la BD Messages ; utilisez un wrapper SSH lorsque le Gateway s’exécute hors Mac
    • Sécurité des MD : le mode par défaut est l’appariement. Le premier MD envoie un code ; approuvez via `openclaw pairing approve

    ` ou utilisez des listes d’autorisation.

Détails du mode distant

Section intitulée « Détails du mode distant »

Le mode distant configure cette machine pour se connecter à une passerelle située ailleurs.

Ce que vous définissez :

  • URL de la passerelle distante (ws://...)
  • Jeton si l’authentification de la passerelle distante est requise (recommandé)

Options d’authentification et de modèle

Section intitulée « Options d’authentification et de modèle »
Clé API AnthropicAPI

Utilise ANTHROPIC_API_KEY si elle est présente ou demande une clé, puis l’enregistre pour utilisation par le démon.

Abonnement Code OpenAI (OAuth)

Flux navigateur ; collez code#state.

Définit agents.defaults.model sur openai/gpt-5.5 via le runtime Codex lorsque le modèle n’est pas défini ou déjà de la famille OpenAI.

Abonnement Code OpenAI (appareil)

Flux de jumelage navigateur avec un code d’appareil à courte durée de vie.

Définit agents.defaults.model sur openai/gpt-5.5 via le runtime Codex lorsque le modèle n’est pas défini ou déjà de la famille OpenAI.

Clé API OpenAIAPI

Utilise OPENAI_API_KEY si présent ou demande une clé, puis stocke les informations d’identification dans les profils d’auth.

Définit agents.defaults.model sur openai/gpt-5.5 lorsque le modèle n’est pas défini, openai/*, ou pour les références de modèle Codex héritées.

OAuthxAI (Grok) OAuth

Connexion via navigateur pour les comptes SuperGrok ou X Premium éligibles. C’est la méthode xAI recommandée pour la plupart des utilisateurs. OpenClaw stocke le profil d’authentification résultant pour les modèles Grok, Grok web_search, x_search et code_execution.

Code d'appareil xAI (Grok)

Connexion via navigateur adaptée aux accès distants avec un code court au lieu d’un rappel localhost. Utilisez ceci depuis SSH, Docker, ou des hôtes VPS.

APIxAI (Grok) API key

Demande XAI_API_KEYAPIOAuth et configure xAI en tant que fournisseur de modèle. Utilisez cette option lorsque vous préférez une clé d’API de console xAI plutôt que l’authentification OAuth par abonnement.

OpenCode

Demande OPENCODE_API_KEY (ou OPENCODE_ZEN_API_KEY) et vous permet de choisir le catalogue Zen ou Go. URL de configuration : opencode.ai/auth.

APIClé API (générique)

Stocke la clé pour vous.

VercelGatewayVercel AI Gateway

Demande AI_GATEWAY_API_KEYVercelGateway. Plus de détails : Vercel AI Gateway.

GatewayCloudflare AI Gateway

Demande l’ID de compte, l’ID de passerelle et CLOUDFLARE_AI_GATEWAY_API_KEYGateway. Plus de détails : Cloudflare AI Gateway.

MiniMaxMiniMax

La configuration est écrite automatiquement. L’hébergement par défaut est MiniMax-M3 ; la configuration de la clé API utilise minimax/..., et la configuration OAuth utilise minimax-portal/...MiniMax. Plus de détails : MiniMax.

StepFun

La configuration est écrite automatiquement pour StepFun standard ou Step Plan sur les points de terminaison en Chine ou mondiaux. Standard inclut actuellement step-3.5-flash, et Step Plan inclut également step-3.5-flash-2603. Plus de détails : StepFun.

Synthétique (compatible Anthropic)

Demande SYNTHETIC_API_KEY. Plus de détails : Synthétique.

Ollama (Cloud et modèles open locaux)

Demande d’abord Cloud + Local, Cloud only, ou Local only. Cloud only utilise OLLAMA_API_KEY avec https://ollama.com. Les modes pris en charge par l’hôte demandent l’URL de base (par défaut http://127.0.0.1:11434), découvrent les modèles disponibles et suggèrent des valeurs par défaut. Cloud + Local vérifie également si cet hôte Ollama est connecté pour l’accès cloud. Plus de détails : Ollama.

Moonshot et Kimi Coding

Les configurations Moonshot (Kimi K2) et Kimi Coding sont écrites automatiquement. Plus de détails : Moonshot AI (Kimi + Kimi Coding).

Fournisseur personnalisé

Fonctionne avec les points de terminaison compatibles OpenAI et Anthropic.

L’intégration interactive prend en charge les mêmes options de stockage de clé API que les autres flux de clés API de fournisseur :

  • Coller la clé API maintenant (texte brut)
  • Utiliser une référence secrète (réf. env ou réf. de fournisseur configurée, avec validation préalable)

Indicateurs non interactifs :

  • --auth-choice custom-api-key
  • --custom-base-url
  • --custom-model-id
  • --custom-api-key (facultatif ; revient à CUSTOM_API_KEY)
  • --custom-provider-id (facultatif)
  • `—custom-compatibility

(facultatif ; par défautopenai) - —custom-image-input/—custom-text-input` (facultatif ; remplace la capacité d’entrée du modèle déduite)

Ignorer

Laisse l’auth non configurée.

Comportement du modèle :

  • Choisissez le modèle par défaut parmi les options détectées, ou saisissez le fournisseur et le modèle manuellement.
  • L’onboarding du fournisseur personnalisé déduit la prise en charge des images pour les ID de modèle courants et ne demande que lorsque le nom du modèle est inconnu.
  • Lorsque l’onboarding démarre à partir d’un choix d’authentification de fournisseur, le sélecteur de modèle privilégie automatiquement ce fournisseur. Pour Volcengine et BytePlus, la même préférence correspond également à leurs variantes de plan de codage (volcengine-plan/*, byteplus-plan/*).
  • Si ce filtre de fournisseur préféré devait être vide, le sélecteur revient au catalogue complet au lieu de n’afficher aucun modèle.
  • L’assistant exécute une vérification du modèle et avertit si le modèle configuré est inconnu ou s’il manque une auth.

Chemins des identifiants et des profils :

  • Profils d’authentification (clés API + OAuth) : APIOAuth~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Importation OAuth héritée : OAuth~/.openclaw/credentials/oauth.json

Mode de stockage des identifiants :

  • Le comportement d’intégration par défaut conserve les clés API en tant que valeurs en texte brut dans les profils d’authentification.
  • --secret-input-mode ref active le mode référence au lieu du stockage de clé en texte clair. Dans la configuration interactive, vous pouvez choisir :
    • réf de variable d’environnement (par exemple keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
    • réf de fournisseur configuré (file ou exec) avec alias + id du fournisseur
  • Le mode référence interactif exécute une validation préliminaire rapide avant l’enregistrement.
    • Références d’env : valide le nom de la variable + la valeur non vide dans l’environnement d’intégration actuel.
    • Références de provider : valide la configuration du provider et résout l’ID demandé.
    • Si la validation préliminaire échoue, l’intégration affiche l’erreur et vous permet de réessayer.
  • En mode non interactif, --secret-input-mode ref est basé uniquement sur les variables d’environnement.
    • Définissez la variable d’environnement du provider dans l’environnement du processus d’intégration.
    • Les drapeaux de clé en ligne (par exemple --openai-api-key) exigent que cette variable d’environnement soit définie ; sinon, l’onboarding échoue rapidement.
    • Pour les fournisseurs personnalisés, le mode non interactif ref stocke models.providers.<id>.apiKey sous forme de { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
    • Dans ce cas de provider personnalisé, --custom-api-key exige que CUSTOM_API_KEY soit défini ; sinon, l’onboarding échoue rapidement.
  • Les identifiants d’authentification Gateway prennent en charge les choix de texte brut et SecretRef dans la configuration interactive :
    • Mode Jeton : Générer/stocker le jeton en texte brut (par défaut) ou Utiliser SecretRef.
    • Mode Mot de passe : texte brut ou SecretRef.
  • Chemin SecretRef du jeton non interactif : --gateway-token-ref-env <ENV_VAR>.
  • Les configurations existantes en texte brut continuent de fonctionner sans modification.

Sorties et fonctionnement interne

Section intitulée « Sorties et fonctionnement interne »

Champs typiques dans ~/.openclaw/openclaw.json :

  • agents.defaults.workspace
  • agents.defaults.skipBootstrap lorsque --skip-bootstrap est passé
  • agents.defaults.model / models.providers (si Minimax est choisi)
  • tools.profile (l’onboarding local utilise "coding" par défaut s’il n’est pas défini ; les valeurs explicites existantes sont conservées)
  • gateway.* (mode, bind, auth, tailscale)
  • session.dmScope (l’onboarding local définit cela par défaut à per-channel-peer s’il n’est pas défini ; les valeurs explicites existantes sont conservées)
  • channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
  • Listes de canaux autorisés (Slack, Discord, Matrix, Microsoft Teams) lorsque vous acceptez lors des invites (les noms sont résolus en ID si possible)
  • skills.install.nodeManager
    • L’indicateur setup --node-manager accepte npm, pnpm ou bun.
    • La configuration manuelle peut toujours définir skills.install.nodeManager: "yarn" plus tard.
  • wizard.lastRunAt
  • wizard.lastRunVersion
  • wizard.lastRunCommit
  • wizard.lastRunCommand
  • wizard.lastRunMode

openclaw agents add écrit agents.list[] et bindings facultatif.

Les identifiants WhatsApp vont sous ~/.openclaw/credentials/whatsapp/<accountId>/. Les sessions sont stockées sous ~/.openclaw/agents/<agentId>/sessions/.

Assistant Gateway RPC :

  • wizard.start
  • wizard.next
  • wizard.cancel
  • wizard.status

Les clients (application macOS et interface de contrôle) peuvent afficher les étapes sans avoir à réimplémenter la logique d’onboarding.

Comportement de la configuration Signal :

  • Télécharge l’actif de version approprié
  • Le stocke sous ~/.openclaw/tools/signal-cli/<version>/
  • Écrit channels.signal.cliPath dans la configuration
  • Les builds JVM nécessitent Java 21
  • Les builds natifs sont utilisés lorsqu’ils sont disponibles
  • Windows utilise WSL2 et suit le flux signal-cli Linux à l’intérieur de WSL

Documentation connexe

Section intitulée « Documentation connexe »