Vous rêvez d'un assistant IA personnel utilisable dans toutes vos applications de messagerie, capable de se souvenir de vos conversations et de vous envoyer proactivement des rappels ? Clawdbot est précisément ce projet open source révolutionnaire qui transforme Claude AI en votre véritable assistant exclusif.
Valeur ajoutée : En lisant cet article, vous maîtriserez les concepts clés de Clawdbot, sa méthode d'installation et de configuration, ainsi que la manière de l'intégrer via API pour qu'il vous serve sur plus de 8 plateformes comme Discord, Telegram ou WhatsApp.
Clawdbot, c'est quoi ? L'essentiel en une phrase
Clawdbot est un projet d'assistant IA personnel open source développé par Peter Steinberger (fondateur de PSPDFKit). Contrairement aux versions web classiques de ChatGPT ou Claude, Clawdbot s'exécute directement dans vos applications de messagerie habituelles : vous envoyez un message sur WhatsApp, il répond sur WhatsApp ; vous posez une question sur Discord, il vous répond sur Discord.
| Caractéristiques | Clawdbot | IA Chat classique |
|---|---|---|
| Mode d'utilisation | Dans vos apps de messagerie habituelles | Nécessite d'ouvrir une page web dédiée |
| Mémoire des conversations | Mémoire persistante multiplateforme | Chaque conversation est isolée |
| Push proactif | Supporte les rappels et notifications | Réponse passive uniquement |
| Stockage des données | Fichiers Markdown locaux | Stocké dans le cloud |
| Capacité de personnalisation | Système de "Skills" entièrement programmable | Options de personnalisation limitées |
🎯 L'essentiel à retenir : Clawdbot n'est pas un modèle d'IA en soi, mais une « passerelle IA ». Il se charge de connecter vos applications de messagerie aux API des grands modèles de langage, permettant aux capacités de l'IA de s'intégrer naturellement à vos outils de communication quotidiens.
Architecture centrale de Clawdbot : une conception en 3 couches
Comprendre l'architecture de Clawdbot est essentiel pour sa configuration et le dépannage futur. Il adopte une conception claire en trois couches :
Première couche : Gateway (Passerelle)
La Gateway est le cœur du plan de contrôle de Clawdbot, écoutant par défaut sur localhost:18789 :
- Gère toutes les sessions de message.
- Route les messages entre les différents canaux.
- Traite les appels d'outils et l'exécution des Skills.
- Maintient l'historique des conversations et le système de mémoire.
Deuxième couche : Channels (Canaux)
Les Channels se chargent de connecter les diverses plateformes de messagerie :
| Type de canal | Plateformes supportées | Mode de connexion |
|---|---|---|
| Messagerie instantanée | WhatsApp, Telegram, Signal | API Bot / Protocole Web |
| Plateformes collaboratives | Discord, Slack, Teams | API Bot |
| Écosystème Apple | iMessage, macOS | imsg CLI / Intégration native |
| Protocoles ouverts | Matrix, WebChat | Connexion via protocole standard |
| Applications régionales | Zalo, BlueBubbles | Plugins communautaires |
Troisième couche : Grand modèle de langage (LLM)
Clawdbot prend en charge plusieurs backends de modèles d'IA :
| Fournisseur de modèle | Mode d'authentification | Cas d'utilisation |
|---|---|---|
| Anthropic Claude | Clé API / OAuth | Recommandé, optimisation native Clawdbot |
| OpenAI GPT | Clé API / OAuth | Scénarios polyvalents |
| Proxy API tiers | Clé API | Optimisation des coûts, facilité d'accès |
🎯 Conseil technique : Pour l'appel des modèles Claude, nous vous suggérons d'obtenir une clé API via la plateforme APIYI (apiyi.com). Cette plateforme prend en charge toute la gamme des modèles Claude 4, propose une interface compatible OpenAI unifiée, offre des tarifs avantageux et simplifie les paiements internationaux.
Détails des 4 avantages clés de Clawdbot
Avantage n°1 : Un accès omnicanal fluide
Le concept « omnicanal » de Clawdbot signifie :
- Un seul assistant, plusieurs points d'entrée : commencez une discussion sur WhatsApp via votre mobile et poursuivez-la sur Discord depuis votre ordinateur.
- Synchronisation automatique du contexte : quel que soit le canal utilisé, l'assistant garde en mémoire le contenu de vos échanges précédents.
- Routage intelligent des messages : vous pouvez configurer l'envoi de types de messages spécifiques vers des canaux particuliers.
Avantage n°2 : Un système de mémoire persistante
Alors que les chats IA traditionnels sont souvent « amnésiques » à chaque nouvelle session, Clawdbot :
- Stocke la mémoire dans des fichiers Markdown, de la même manière que des notes Obsidian.
- Prend en charge la recherche sémantique, ce qui lui permet de faire le lien avec des informations que vous avez mentionnées auparavant.
- Propose un stockage entièrement local, vos données ne sont jamais envoyées sur le cloud.
~/clawd/
├── memories/ # Mémoire des conversations
│ ├── 2026-01-26.md # Organisé par date
│ └── topics/ # Classé par sujet
├── skills/ # Compétences personnalisées
└── config.yaml # Fichier de configuration
Avantage n°3 : Capacité de push proactif
C'est la fonctionnalité phare qui distingue Clawdbot des autres assistants IA :
| Scénario de push proactif | Exemple |
|---|---|
| Briefing matinal | Envoi de l'agenda et de la météo chaque matin à 8h |
| Rappel de tâches | Rappel avant les dates d'échéance que vous avez mentionnées |
| Alertes de surveillance | Notification proactive en cas d'anomalie sur un site web surveillé |
| Exécution programmée | Exécution régulière de scripts avec rapport des résultats |
Avantage n°4 : Le système de compétences (Skills)
Les Skills sont les « extensions » de Clawdbot, définies simplement via des fichiers Markdown ou TypeScript :
# skill: web-search
Utilise l'API Brave Search pour rechercher du contenu sur le web
## Conditions de déclenchement
Lorsque l'utilisateur pose une question nécessitant des informations en temps réel
Étapes d'exécution
- Appel de l'API Brave Search
- Analyse des résultats de recherche
- Génération d'une réponse résumée
La communauté a déjà contribué plus de 100 Skills prêts à l'emploi, couvrant :
- Navigation web et captures d'écran
- Opérations de lecture et d'écriture de fichiers
- Intégration de la gestion d'agenda
- Environnement d'exécution de code
- Contrôle de la maison connectée (Smart Home)
---
## Installation et configuration de Clawdbot : 3 étapes pour démarrer rapidement
### Prérequis système
| Élément | Exigence |
|------|------|
| **Node.js** | ≥ 22.x |
| **Système d'exploitation** | macOS / Linux / Windows (WSL2) |
| **Mémoire** | ≥ 2 Go disponible |
| **Clé API d'IA** | Clé API Claude ou OpenAI |
### Étape 1 : Installation globale
```bash
# Installer avec npm (recommandé)
npm install -g clawdbot@latest
# Ou utiliser pnpm
pnpm add -g clawdbot@latest
Étape 2 : Lancer l'assistant de configuration
# Démarrer l'assistant de configuration interactif
clawdbot onboard --install-daemon
L'assistant vous guidera pour :
- Configuration du modèle d'IA – Saisissez votre clé API Claude ou OpenAI.
- Paramétrage du répertoire de travail – Par défaut
~/clawd. - Activation des canaux – Choisissez les plateformes de messagerie à connecter.
- Installation du démon – Pour que la Gateway continue de fonctionner en arrière-plan.
🚀 Démarrage rapide : Si vous n'avez pas encore de clé API Claude, nous vous recommandons d'utiliser la plateforme APIYI (apiyi.com) pour en obtenir une rapidement. Cette plateforme propose des interfaces API prêtes à l'emploi, offre un crédit de test gratuit dès l'inscription, et permet de finaliser la configuration en 5 minutes.
Étape 3 : Vérifier l'installation
# Vérifier l'état du service
clawdbot status
# Bilan de santé approfondi
clawdbot health
# Diagnostiquer les problèmes de configuration
clawdbot doctor
Sortie attendue :
Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord, Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed
Guide de configuration de l'intégration Discord pour Clawdbot
Discord est l'un des canaux les plus utilisés pour Clawdbot. Voici les étapes à suivre pour le configurer :
Étape 1 : Créer le bot Discord
- Rendez-vous sur le Portail des Développeurs Discord :
discord.com/developers/applications - Cliquez sur « New Application » pour créer une application.
- Allez dans l'onglet « Bot » et cliquez sur « Add Bot ».
- Notez bien votre Bot Token (cliquez sur « Reset Token » pour le générer).
Étape 2 : Configurer les permissions du bot
Dans la section « OAuth2 → URL Generator », cochez les cases suivantes :
| Catégorie de permission | Permissions spécifiques |
|---|---|
| Scopes | bot, applications.commands |
| Bot Permissions | Send Messages, Read Message History, Embed Links |
Étape 3 : Inviter le bot sur votre serveur
Utilisez l'URL OAuth2 générée pour inviter le bot sur votre serveur Discord.
Étape 4 : Configurer Clawdbot
# Configuration interactive du canal Discord
clawdbot configure --section channels.discord
Une fois le Bot Token saisi, Clawdbot finalisera automatiquement la connexion.
Étape 5 : Tester la conversation
Dans votre serveur Discord, mentionnez votre bot (@votre-bot) ou envoyez-lui un message privé :
@ClawdBot Bonjour, présente-toi.
Le bot utilisera l'API Claude pour générer une réponse et l'enverra sur Discord.
Détails de la configuration de l'API Clawdbot
L'intelligence de Clawdbot provient des grands modèles de langage (LLM) sous-jacents. Il est donc crucial de configurer correctement l'API.
API Anthropic officielle
# ~/clawd/config.yaml
llm:
provider: anthropic
model: claude-sonnet-4-20250514
apiKey: sk-ant-xxxxx
Avantages :
- Connexion directe à l'officiel, latence minimale.
- Accès aux tout derniers modèles.
Limitations :
- Nécessite une carte de paiement internationale.
- Accès restreint dans certaines régions.
Proxy API tiers (Recommandé)
# ~/clawd/config.yaml
llm:
provider: openai-compatible
model: claude-sonnet-4-20250514
apiKey: sk-xxxxx
baseUrl: https://api.apiyi.com/v1 # Utilisation de l'interface unifiée APIYI
💰 Optimisation des coûts : Pour plus de simplicité, utiliser APIYI (apiyi.com) comme proxy API est un excellent choix. La plateforme propose une interface compatible avec le format OpenAI, supporte toute la gamme Claude, offre des tarifs souvent plus avantageux que l'officiel, et accepte des moyens de paiement locaux sans avoir besoin d'une carte bancaire étrangère.
Authentification par abonnement OAuth
Si vous possédez déjà un abonnement Claude Pro/Max :
clawdbot configure --section llm.oauth
L'avantage est d'utiliser votre quota d'abonnement existant, sans frais d'API supplémentaires.
Configurations des skills courantes de Clawdbot
Skill de recherche Web
# 配置 Brave Search API
clawdbot configure --section web
# 输入你的 Brave Search API Key
Une fois configuré, Clawdbot peut effectuer des recherches sur le Web en temps réel pour répondre aux questions.
Skill d'opérations sur les fichiers
Clawdbot dispose de capacités de lecture et d'écriture de fichiers intégrées :
我: 帮我读取 ~/Documents/notes.md 的内容
Bot: 正在读取文件... [文件内容]
我: 在文件末尾添加一行 "今日待办: 完成报告"
Bot: 已添加内容到文件
Skill de navigateur
我: 帮我访问 example.com 并截图
Bot: [启动浏览器] → [加载页面] → [生成截图] → [返回图片]
Skill personnalisé
Il suffit de créer un fichier Markdown dans le répertoire ~/clawd/skills/ :
# skill: daily-report
每日工作汇报生成器
## 描述
根据今日对话记录生成工作日报
Mots-clés de déclenchement
Générer un rapport journalier, Résumé du jour
Logique d'exécution
- Lire tous les souvenirs de conversation de la journée
- Extraire le contenu lié au travail
- Générer un rapport journalier structuré
Clawdbot : Estimation des coûts et comparaison
| Poste de dépense | Coût mensuel | Description |
|---|---|---|
| Serveur VPS | 35-70 ¥ | Optionnel, gratuit en exécution locale |
| API Claude | 70-140 ¥ | Dépend du volume d'utilisation |
| Abonnement Claude Pro | 140 ¥ | L'authentification via OAuth permet d'économiser les frais d'API |
| Abonnement Claude Max | 1400 ¥ | Pour les utilisateurs intensifs, Opus en illimité |
Conseils d'optimisation des coûts
- Exécution locale : Faites-le tourner sur votre ordinateur personnel ou un Mac mini pour économiser les frais de VPS.
- Proxy API : Passez par APIYI (apiyi.com) pour appeler l'API Claude, les tarifs y sont plus avantageux.
- Choix du modèle : Utilisez
claude-haikupour les échanges quotidiens et basculez surclaude-sonnetpour les tâches complexes. - Gestion de la mémoire : Nettoyez régulièrement les souvenirs inutiles pour réduire la consommation de tokens.
Comparaison entre Clawdbot et les autres solutions
| Dimension de comparaison | Clawdbot | ChatGPT App | Claude App | Bot DIY |
|---|---|---|---|---|
| Support multiplateforme | ⭐⭐⭐⭐⭐ 8+ plateformes | ⭐⭐ App uniquement | ⭐⭐ App uniquement | ⭐⭐⭐ Développement individuel |
| Mémoire de conversation | ⭐⭐⭐⭐⭐ Stockage local persistant | ⭐⭐⭐ Cloud limité | ⭐⭐⭐ Cloud limité | ⭐⭐ À implémenter soi-même |
| Notifications push | ⭐⭐⭐⭐⭐ Support complet | ❌ Non supporté | ❌ Non supporté | ⭐⭐⭐ À implémenter soi-même |
| Protection vie privée | ⭐⭐⭐⭐⭐ Stockage local | ⭐⭐ Stockage cloud | ⭐⭐ Stockage cloud | ⭐⭐⭐⭐ Dépend de l'implémentation |
| Personnalisation | ⭐⭐⭐⭐⭐ Système de Skills | ⭐⭐ GPTs limité | ⭐⭐ Projets | ⭐⭐⭐⭐⭐ Totalement sur mesure |
| Prise en main | ⭐⭐⭐ Bases techniques requises | ⭐⭐⭐⭐⭐ Prêt à l'emploi | ⭐⭐⭐⭐⭐ Prêt à l'emploi | ⭐ Nécessite beaucoup de dév |
💡 Conseil de choix : Clawdbot est idéal pour les utilisateurs ayant un bagage technique, qui recherchent la confidentialité et une personnalisation poussée. Si vous avez juste besoin d'une simple conversation avec l'IA, les apps officielles suffiront ; si vous voulez que l'IA s'intègre réellement dans votre flux de travail quotidien, Clawdbot vaut largement le temps d'apprentissage.
FAQ (Foire aux questions)
Q1 : Est-ce que Clawdbot a besoin d’un serveur VPS ?
Ce n'est pas indispensable. Clawdbot peut tourner sur votre ordinateur personnel, du moment qu'il reste allumé. Cependant, si vous voulez qu'il soit disponible 24h/24, on vous conseille d'utiliser :
- Un ordinateur toujours allumé à la maison (type Mac mini, etc.)
- Un serveur cloud (VPS, environ 5-10 €/mois)
- Un NAS local
Q2 : Comment obtenir l’API Claude sans carte bancaire étrangère ?
Vous pouvez passer par la plateforme APIYI (apiyi.com) pour accéder à l'API Claude. Elle accepte les paiements via Alipay et WeChat, propose une interface API identique à l'officielle, et souvent à des tarifs plus avantageux. Une fois inscrit, récupérez votre clé API et configurez-la dans Clawdbot pour commencer.
Q3 : Clawdbot gère-t-il le français ?
Absolument. Clawdbot n'est qu'une passerelle ; l'intelligence vient des modèles sous-jacents (Claude/GPT). Ces grands modèles de langage gèrent parfaitement le français, vous pouvez donc interagir avec Clawdbot entièrement dans cette langue.
Q4 : Comment la confidentialité des conversations est-elle assurée ?
Clawdbot adopte une approche « local-first » :
- L'historique des conversations est stocké sur votre propre appareil (fichiers Markdown).
- La passerelle (Gateway) tourne en local (localhost) et n'est pas exposée sur le réseau public.
- L'accès sécurisé peut se faire via un tunnel SSH ou Tailscale.
- Seuls les appels aux modèles d'IA nécessitent une connexion internet (requêtes API).
Q5 : Où demander de l’aide en cas de problème ?
Clawdbot dispose d'une communauté active :
- Serveur Discord : Une fois membre, vous pouvez discuter directement avec deux instances de Clawdbot et poser vos questions.
- GitHub Issues :
github.com/clawdbot/clawdbot - Documentation officielle :
docs.clawd.bot
Les retours de bugs sont généralement traités rapidement, et il arrive même que l'auteur les corrige en direct pendant une discussion.
Q6 : Comment l’installer sur Windows ?
Pour les utilisateurs Windows, on recommande vivement d'utiliser WSL2 :
- Installez WSL2 (la distribution Ubuntu est conseillée).
- Installez Node.js 22+ dans WSL2.
- Suivez les étapes d'installation Linux pour Clawdbot.
Le support natif sur Windows n'est pas encore optimal et peut engendrer divers problèmes.
Usages avancés de Clawdbot
1. Collaboration multi-agents
Clawdbot permet de créer plusieurs sessions qui peuvent communiquer entre elles :
Session A (Assistant de recherche) : Analyse les données du marché.
Session B (Assistant de rédaction) : Reçoit les données de A et génère un rapport.
Session C (Assistant de relecture) : Vérifie le rapport de B et propose des corrections.
2. Workflows automatisés
En combinant Clawdbot avec des tâches planifiées (Cron) :
- Tous les matins à 8h : Résumé des emails importants.
- Chaque lundi à 9h : Génération du compte-rendu de la semaine passée.
- Le 1er du mois : Statistiques sur la consommation de l'API ce mois-ci.
3. Intégration domotique
Connectez vos appareils intelligents via Home Assistant ou MQTT :
Moi : Baisse un peu la lumière du salon.
Bot : [Appel API Home Assistant] Luminosité du salon réglée à 50 %.
4. Assistant au développement
Clawdbot peut :
- Lire et expliquer des fichiers de code.
- Exécuter des commandes shell.
- Parcourir des dépôts GitHub.
- Générer du code et l'enregistrer directement dans un fichier.
Conclusion et prochaines étapes
Clawdbot représente un nouveau paradigme pour les assistants IA personnels :
| Valeur fondamentale | Description |
|---|---|
| Omniprésence | Utilisez l'IA directement dans vos applications de messagerie habituelles |
| N'oublie jamais | Mémoire persistante, pour un assistant qui vous connaît vraiment |
| Service proactif | N'attend plus passivement ; envoie des rappels de manière proactive |
| Contrôle total | Open source et auto-hébergé, vos données vous appartiennent pour toujours |
| Extension infinie | Le système de Skills repousse les limites de ses capacités |
Prochaines étapes :
- Installer Clawdbot :
npm install -g clawdbot@latest - Obtenir l'API Claude : Recommandé via APIYI (apiyi.com) pour une obtention rapide
- Lancer l'assistant de configuration :
clawdbot onboard --install-daemon - Connectez votre premier canal (nous vous recommandons de commencer par Discord)
- Rejoignez la communauté Discord de Clawdbot pour partager votre expérience
Références
-
Site officiel de Clawdbot : Présentation du produit et démarrage rapide
- Lien :
clawd.bot
- Lien :
-
Documentation officielle de Clawdbot : Guide de configuration complet
- Lien :
docs.clawd.bot
- Lien :
-
Dépôt GitHub : Code open source et gestion des tickets (Issues)
- Lien :
github.com/clawdbot/clawdbot
- Lien :
-
Test approfondi de MacStories : Partage d'expérience utilisateur
- Lien :
macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/
- Lien :
-
Site personnel de Peter Steinberger : Blog de l'auteur
- Lien :
steipete.me
- Lien :
📝 Auteur : Équipe APIYI
🔗 Échange technique : Visitez apiyi.com pour plus d'astuces sur l'utilisation des API d'IA
📅 Date de mise à jour : Janvier 2026
