OpenClaw & Moltbook FAQ

OpenClaw est un framework d'assistant IA open-source qui vous permet de déployer votre propre assistant IA sur plusieurs plateformes de messagerie (WhatsApp, Telegram, Discord, etc.). Moltbook est un service partagé communautaire où les utilisateurs d'OpenClaw peuvent rejoindre des instances existantes sans auto-hébergement. Idéal pour : développeurs, passionnés de technologie, équipes ayant besoin d'assistants IA privés, et quiconque souhaite contrôler ses interactions avec l'IA.

Desktop (GUI) est recommandé pour les débutants - il offre une configuration visuelle, des logs en temps réel et des opérations en un clic. CLI est meilleur pour : • Déploiements sur serveur • Automatisation et scripts • Environnements à ressources limitées • Développeurs préférant les workflows terminal Les deux versions partagent les mêmes fonctionnalités de base.

Votre liste de succès minimum : 1. OpenClaw installé et en cours d'exécution (vérifier l'état de santé) 2. Au moins une clé API de modèle configurée (OpenAI, Anthropic, etc.) 3. Un canal de messagerie connecté (nous recommandons Telegram pour les débutants) 4. Envoyer un message test et recevoir une réponse Cela prend généralement 5-10 minutes avec la version Desktop.

Requis : • Au moins une clé API de modèle IA (OpenAI, Anthropic, Google, etc.) Pour l'intégration de canal (au moins un) : • WhatsApp : Juste votre téléphone avec WhatsApp installé • Telegram : Créer un bot via @BotFather • Discord : Créer une application dans le Discord Developer Portal Optionnel : • Clés API de recherche web pour des capacités améliorées

Commencer avec un canal vous aide à : • Vous concentrer sur maîtriser les bases • Comprendre clairement le flux des messages • Déboguer les problèmes plus facilement • Gagner en confiance avant d'ajouter de la complexité Une fois à l'aise, ajouter plus de canaux est simple.

Après l'installation, vérifiez : 1. Exécutez `openclaw health` ou `openclaw status` (CLI) ou vérifiez l'état de santé dans Desktop 2. Recherchez des coches vertes sur tous les services 3. Vérifiez que le gateway est accessible (par défaut : http://127.0.0.1:18789) 4. Consultez les logs pour des messages d'erreur Si toutes les vérifications passent, vous êtes prêt à configurer les canaux.

Top 5 des problèmes de démarrage : 1. Port déjà utilisé (autre app utilisant 18789) 2. Clés API manquantes ou invalides 3. Permissions insuffisantes (essayez en admin) 4. Pare-feu bloquant les connexions 5. Dépendances obsolètes (Node.js v22+ requis) Consultez d'abord les logs - ils indiquent généralement le problème exact.

Solutions : 1. Trouvez et arrêtez le processus en conflit : • Mac/Linux : `lsof -i :18789` puis `kill [PID]` • Windows (WSL) : `lsof -i :18789` puis `kill [PID]` 2. Ou changez le port d'OpenClaw : • Utilisez `openclaw gateway --port 18790` au démarrage • Ou spécifiez `--gateway-port 18790` pendant onboard

Essayez ces étapes dans l'ordre : 1. Vérifiez les logs : `openclaw logs --follow` pour voir les erreurs 2. Reconfigurez : exécutez `openclaw configure` pour réinitialiser 3. Réinstallez : `npm install -g openclaw@latest` 4. Consultez les notes de version pour les changements majeurs 5. Si ça échoue toujours, signalez avec les logs sur GitHub Issues

OpenClaw utilise principalement `~/.openclaw/openclaw.json` pour la configuration. Problèmes courants : 1. Service non redémarré après changements de config 2. Mauvais chemin de fichier de configuration 3. Erreurs de syntaxe JSON (virgules, guillemets manquants) 4. Variables d'environnement doivent être passées via paramètres onboard Vérifier la config : exécutez `openclaw status` pour voir les paramètres actifs.

Imaginez un restaurant : • Modèle = Le chef (IA qui génère les réponses) • Canal = L'entrée (WhatsApp, Telegram, etc.) • Gateway = L'accueil (reçoit et route les requêtes) • Skills = Capacités spéciales (recherche web, exécution de code, etc.) Vous avez besoin d'au moins un modèle et un canal. Le gateway s'exécute automatiquement. Les Skills sont des améliorations optionnelles.

Le plus simple est d'exécuter l'assistant de configuration interactif : ``` $ openclaw onboard ``` L'assistant vous guide à travers : • Sélection d'un fournisseur de modèle IA (Anthropic/OpenAI etc.) • Saisie de votre clé API • Installation et démarrage du service gateway Après configuration, connectez un canal avec `openclaw channels login telegram`. Le gateway par défaut se lie à 127.0.0.1:18789 (accès local uniquement - sécurisé).

Dans Desktop : Paramètres → Skills → Basculer on/off En CLI : • Lister les skills disponibles : `openclaw skills list` • Installer un skill : `openclaw skills install [skill-name]` • Activer un skill : `openclaw skills enable [skill-name]` Conseils de sécurité : • Désactivez les skills dont vous n'avez pas besoin • Vérifiez les permissions du skill avant d'activer • Testez les nouveaux skills d'abord en environnement sûr • Certains skills peuvent exécuter du code - activez avec prudence

Changer de modèle : 1. Exécutez `openclaw onboard` à nouveau pour reconfigurer avec un nouveau fournisseur 2. Ou éditez les paramètres agents.defaults.model dans `~/.openclaw/openclaw.json` 3. Redémarrez le service : `openclaw gateway status` pour vérifier Si le nouveau modèle échoue : • Exécutez `openclaw models status` pour vérifier la connexion du modèle • Vérifiez la validité de la clé API sur le site du fournisseur • Vérifiez l'orthographe du nom du modèle (ex. `anthropic/claude-opus-4-5`) • Vérifiez les limites de taux ou quota sur votre compte

Liste de sécurité : ✓ Garder le gateway sur localhost (127.0.0.1) par défaut ✓ Ne jamais exposer le port directement sur internet public ✓ Si accès distant nécessaire, utiliser : • VPN ou tunnel SSH • Proxy inverse avec authentification • Cloudflare Tunnel ✓ Activer l'authentification si disponible ✓ Utiliser HTTPS en production

Essayez ces corrections : 1. Assurez-vous que téléphone et ordinateur sont sur le même réseau 2. Actualisez le code QR (ils expirent vite) 3. Mettez à jour WhatsApp vers la dernière version sur le téléphone 4. Videz le cache du navigateur si vous utilisez l'interface web 5. Essayez de scanner dans un environnement bien éclairé 6. Désactivez temporairement le VPN Si ça échoue toujours, essayez la méthode du code de liaison téléphone.

Les problèmes de session sont généralement causés par : 1. Téléphone hors ligne ou en veille 2. WhatsApp déconnecté sur le téléphone 3. Utilisation de WhatsApp Web sur un autre appareil 4. Instabilité réseau Solutions : • Garder le téléphone connecté à un WiFi stable • Désactiver l'optimisation de batterie pour WhatsApp • Ne pas ouvrir WhatsApp Web ailleurs • Vérifier les mises à jour de l'app WhatsApp

Le comportement de groupe est généralement intentionnel : • Vérifiez si les réponses de groupe sont activées dans la config • Le bot peut nécessiter une @mention pour répondre dans les groupes • La config par défaut peut désactiver les messages de groupe pour la sécurité Pour activer : • Activez les réponses de groupe dans les paramètres Desktop • Ou gérez les permissions de groupe via `openclaw pairing` • Testez d'abord avec un petit groupe pour s'assurer que ça fonctionne

Les bots Telegram ont le Mode Privé activé par défaut : 1. Ouvrez @BotFather 2. Envoyez /mybots 3. Sélectionnez votre bot 4. Bot Settings → Group Privacy → Turn OFF Alternativement, faites du bot un admin de groupe - les admins peuvent voir tous les messages quel que soit le mode privé.

Étapes simples : 1. Ouvrez Telegram, cherchez @BotFather 2. Envoyez /newbot 3. Choisissez un nom (nom affiché) 4. Choisissez un username (doit finir par 'bot') 5. Copiez le token API fourni 6. Ajoutez le token à votre config OpenClaw Optionnel : Utilisez /setcommands pour ajouter des suggestions de commandes.

Généralement un problème d'intents : 1. Allez sur Discord Developer Portal 2. Sélectionnez votre application → Bot 3. Activez ces Privileged Intents : • MESSAGE CONTENT INTENT • SERVER MEMBERS INTENT (si nécessaire) 4. Sauvegardez et redémarrez votre bot Vérifiez aussi : le bot a la permission de Lire les Messages dans le canal.

Intents requis : • Guilds - info basique du serveur • Guild Messages - recevoir les messages • Message Content - lire le texte des messages (PRIVILÉGIÉ) Optionnel : • Guild Members - info utilisateurs (PRIVILÉGIÉ) • Direct Messages - support DM Note : Les intents privilégiés nécessitent une vérification pour les bots dans 100+ serveurs.

Scopes Bot Token minimum : • chat:write - envoyer des messages • app_mentions:read - répondre aux @mentions • channels:history - lire les messages du canal • im:history - lire les messages DM Event Subscriptions : • message.channels • message.im • app_mention Commencez minimal, ajoutez plus seulement si nécessaire.

401 signifie échec d'authentification. Vérifiez : 1. La clé API est correcte (pas d'espaces en trop) 2. La clé n'a pas expiré ou été révoquée 3. La clé a les permissions/scopes requis 4. Vous n'atteignez pas les limites de taux 5. Le compte a suffisamment de crédits/quota Testez d'abord votre clé directement avec l'API du fournisseur.

Diagnostiquez étape par étape : 1. Testez le modèle directement (curl/Postman) - si lent, c'est le modèle 2. Vérifiez votre vitesse internet et latence 3. Essayez un autre modèle (GPT-3.5 est plus rapide que GPT-4) 4. Vérifiez la page de statut du fournisseur pour les pannes Solutions : • Augmentez les paramètres de timeout • Utilisez le streaming pour les réponses longues • Essayez un autre fournisseur de modèle

Cherchez ces patterns dans les logs : • 'FATAL' ou 'PANIC' - erreurs critiques • 'OOM' - mémoire épuisée • 'ECONNREFUSED' - impossible de connecter à une dépendance • Stack traces - erreurs de code Solutions courantes : • Augmentez l'allocation mémoire • Corrigez les erreurs de configuration • Mettez à jour vers la dernière version • Vérifiez la disponibilité des services externes

Dépannage config : 1. Avez-vous redémarré le gateway ? (Requis pour la plupart des changements) 2. La syntaxe JSON est-elle correcte ? (Vérifiez virgules, guillemets) 3. Bon fichier de config ? (Doit être `~/.openclaw/openclaw.json`) 4. Le gateway tourne-t-il ? (`openclaw gateway status`) Vérifier la config : • `openclaw status` - vérifier le statut global • `openclaw models status` - vérifier les connexions modèle • `openclaw health` - vérification de santé

Emplacements des logs : • Desktop : Affichage → Logs (ou Paramètres → Ouvrir Dossier Logs) • CLI : `~/.openclaw/logs/` ou stdout • Docker : `docker logs [container]` Mots-clés d'erreur importants : • ERROR, FATAL, PANIC - problèmes critiques • timeout, ETIMEDOUT - problèmes de connexion • 401, 403, 429 - problèmes auth/limite de taux • ENOENT - fichier/chemin manquant

Incluez dans votre rapport : 1. Version OpenClaw (`openclaw --version`) 2. OS et version 3. Étapes pour reproduire 4. Comportement attendu vs réel 5. Logs pertinents (supprimez les infos sensibles !) 6. Extrait de config (supprimez les clés API !) Soumettez sur : page GitHub Issues Pour problèmes de sécurité : email au contact sécurité directement

Risques d'exposition publique : • N'importe qui peut envoyer des requêtes à votre IA • Les clés API pourraient être extraites • Potentiel d'abus (spam, contenu illégal) • Explosion des coûts par usage non autorisé • Responsabilité légale pour les actions du bot Options d'accès distant sécurisé : • VPN (recommandé) • Tunnel SSH • Cloudflare Tunnel • Proxy inverse avec auth

Liste de sécurité : 1. Est-ce d'une source officielle/vérifiée ? 2. Vérifiez le code source si disponible 3. Lisez les avis/issues d'autres utilisateurs 4. Comprenez quelles permissions sont demandées 5. Testez d'abord en environnement isolé Signaux d'alerte : • Demande des permissions inutiles • Code obfusqué/minifié • Pas de code source disponible • Pas de retour de la communauté

Agissez immédiatement : 1. RÉVOQUEZ la clé sur le site du fournisseur MAINTENANT 2. Générez une nouvelle clé 3. Mettez à jour toutes vos configs avec la nouvelle clé 4. Vérifiez l'historique d'usage pour des appels non autorisés 5. Revoyez comment elle a fuité (historique git ? repo public ?) Prévention : • Ne jamais committer des clés dans git • Utilisez des fichiers .env (dans gitignore) • Utilisez la gestion des secrets en production

Valeurs par défaut sécurisées : • Gateway lié à localhost uniquement (127.0.0.1) • Skills désactivés par défaut • Messages de groupe désactivés initialement • Limitation de taux activée • Logging activé (pour audit) • Permissions minimales pour les bots de canal Retenez : commencez restrictif, assouplissez seulement si nécessaire.