Assistant de prise en main (CLI)¶

L’assistant de prise en main est la methode recommandee pour configurer OpenClaw sur macOS, Linux ou Windows (via WSL2 ; fortement recommande). Il configure une Gateway (passerelle) locale ou une connexion a une Gateway distante, ainsi que les canaux, les Skills et les parametres par defaut de l’espace de travail, au sein d’un flux guide unique.

openclaw onboard

Premier chat le plus rapide : ouvrez l’UI de controle (aucune configuration de canal requise). Executez openclaw dashboard et discutez dans le navigateur. Docs : Dashboard.

Pour reconfigurer ulterieurement :

openclaw configure
openclaw agents add <name>

--json n’implique pas un mode non interactif. Pour les scripts, utilisez --non-interactive.

Recommande : configurez une cle d’API Brave Search afin que l’agent puisse utiliser web_search (web_fetch fonctionne sans cle). La voie la plus simple : openclaw configure --section web, qui stocke tools.web.search.apiKey. Docs : Web tools.

Démarrage rapide vs Avancé¶

L’assistant demarre avec Démarrage rapide (parametres par defaut) ou Avancé (controle total).

- Gateway (passerelle) locale (loopback) - Espace de travail par defaut (ou espace de travail existant) - Port de la Gateway 18789 - Authentification de la Gateway Token (genere automatiquement, meme en loopback) - Exposition Tailscale Desactivee - Les Messages prives Telegram + WhatsApp sont par defaut en allowlist (vous serez invite a saisir votre numero de telephone) - Expose chaque etape (mode, espace de travail, Gateway, canaux, daemon, Skills).

Ce que configure l’assistant¶

Le mode local (par defaut) vous guide a travers les etapes suivantes :

1. Modele/Auth — Cle d’API Anthropic (recommandee), OAuth, OpenAI ou autres fournisseurs. Choisissez un modele par defaut.
2. Espace de travail — Emplacement des fichiers de l’agent (par defaut ~/.openclaw/workspace). Initialise les fichiers de demarrage.
3. Gateway — Port, adresse de liaison, mode d’authentification, exposition Tailscale.
4. Canaux — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles ou iMessage.
5. Daemon — Installe un LaunchAgent (macOS) ou une unite systemd utilisateur (Linux/WSL2).
6. Verification de sante — Demarre la Gateway et verifie qu’elle s’execute.
7. Skills — Installe les Skills recommandes et les dependances optionnelles.

Relancer l’assistant ne supprime rien, sauf si vous choisissez explicitement Reset (ou passez --reset). Si la configuration est invalide ou contient des cles heritees, l’assistant vous demande d’executer openclaw doctor au prealable.

Le mode distant configure uniquement le client local pour se connecter a une Gateway ailleurs. Il n’installe ni ne modifie rien sur l’hote distant.

Ajouter un autre agent¶

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

Ce que cela configure :

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

Notes :

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

Reference complete¶

Pour des detail pas a pas, le scripting non interactif, la configuration de Signal, l’API RPC et la liste complete des champs de configuration que l’assistant ecrit, consultez la Reference de l’assistant.

Docs associees¶

• Reference des commandes CLI : openclaw onboard
• Prise en main de l’app macOS : Onboarding
• Rituel du premier demarrage de l’agent : Agent Bootstrapping