OpenClaw : Installer et Configurer Votre Assistant IA Personnel 🦞

1. Qu'est-ce qu'OpenClaw ?

OpenClaw (ex-Clawdbot, ex-Moltbot) est un agent IA personnel open-source créé par Peter Steinberger (fondateur de PSPDFKit, recruté par OpenAI en février 2026). Contrairement à ChatGPT qui se limite à des réponses textuelles, OpenClaw agit réellement sur votre machine : il exécute des commandes shell, contrôle un navigateur, lit et écrit des fichiers, gère votre agenda et vos emails.

Sa mascotte : un homard rouge 🦞 (« the lobster way »). Son principe : Your assistant. Your machine. Your rules.

2. Prérequis

3. Installation pas à pas

1 Installer OpenClaw

Le script d'installation inclut Node.js et toutes les dépendances :

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell, installe WSL2 si nécessaire)
irm https://openclaw.ai/install.ps1 | iex

2 Lancer l'assistant d'onboarding

L'assistant interactif guide la configuration complète :

openclaw onboard

Le wizard vous demande successivement : le choix du fournisseur LLM (Anthropic recommandé), votre clé API, les skills à activer, et le canal de communication à connecter.

3 Vérifier l'installation

# Diagnostic complet
openclaw doctor

# Statut local (credentials, sessions)
openclaw status

# Statut approfondi avec tests réseau
openclaw status --deep

4. Le Gateway : cœur du système

Le Gateway est le plan de contrôle central d'OpenClaw. C'est un serveur WebSocket qui orchestre les sessions, les canaux, les outils et les événements. Il tourne par défaut sur ws://127.0.0.1:18789.

# Démarrer le Gateway
openclaw gateway start

# Ouvrir le dashboard dans le navigateur
openclaw dashboard

Le dashboard (Control UI) affiche l'état de vos canaux, les sessions actives, les logs et vous permet de chatter directement depuis le navigateur.

5. Connecter un canal : WhatsApp et Telegram

WhatsApp (le plus populaire)

OpenClaw utilise WhatsApp Web. Un numéro de téléphone dédié est recommandé (pas votre numéro personnel, car chaque message reçu devient une entrée pour l'agent).

# Pendant l'onboarding ou manuellement :
openclaw config set channels.whatsapp.allowFrom '["+33612345678"]'

Un QR code s'affiche. Scannez-le avec l'app WhatsApp du téléphone dédié. Une fois connecté, envoyez un message depuis votre numéro autorisé — l'agent répond directement dans la conversation.

Telegram (le plus simple à configurer)

Créez un bot via @BotFather sur Telegram, récupérez le token, puis :

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.dmPolicy "allowlist"
openclaw config set channels.telegram.allowFrom '["YOUR_TELEGRAM_USER_ID"]'

Autres canaux

6. Personnaliser avec SOUL.md

SOUL.md est le fichier central de personnalité de votre agent. Il définit qui est l'agent, comment il communique, et quelles règles il suit. C'est un simple fichier Markdown.

# ~/.openclaw/workspace/SOUL.md

## Identité
Tu es mon assistant personnel. Tu t'appelles Jarvis.
Tu communiques en français par défaut.

## Ton
Tu es concis, direct et professionnel.
Tu utilises l'humour quand c'est approprié.

## Règles
- Ne partage jamais mes fichiers ou données personnelles
- Demande confirmation avant toute action destructive
- Ne révèle jamais les clés API ou identifiants
- Quand tu doutes, demande plutôt que d'agir

## Contexte
Je suis développeur web. Je travaille principalement en
JavaScript/TypeScript et Python. Mon fuseau horaire est
Europe/Paris.

7. Le workspace : fichiers clés

Le workspace (~/.openclaw/workspace/) contient tous les fichiers de configuration et de mémoire :

Chaque skill est un dossier contenant un fichier SKILL.md avec un frontmatter YAML et des instructions d'utilisation. Le tout est éditable avec n'importe quel éditeur de texte.

8. Skills : étendre les capacités

Les skills sont des modules qui enseignent à l'agent comment interagir avec des outils et services spécifiques. Trois sources principales :

Skills intégrées

Chargées automatiquement au démarrage : navigation web, gestion de fichiers, exécution de commandes, cron jobs.

ClawHub (registre communautaire)

Quand ClawHub est activé, l'agent peut chercher et installer des skills automatiquement. Attention : le registre a été pollué par des skills malveillantes (900+ identifiées). Auditez toujours avec le Cisco Skill Scanner avant d'installer.

skills.sh

Cherchez une skill sur skills.sh, copiez la commande, et demandez à l'agent de l'exécuter :

# Exemple : demandez à l'agent dans le chat
"Installe la skill Gmail depuis skills.sh"

9. Commandes essentielles

Commandes CLI (terminal)

Commandes chat (dans WhatsApp/Telegram/etc.)

10. Déploiement : local vs VPS vs Docker

Config minimale recommandée (VPS)

# Config de base sécurisée (~/.openclaw/openclaw.json)

11. FAQ