OpenClaw + HubSpot : automatiser un CRM avec un agent local

Connecter OpenClaw à HubSpot : le guide complet

Connecter OpenClaw à HubSpot via le Model Context Protocol (MCP) permet à un agent IA autonome de lire, écrire et raisonner sur vos données CRM sans intervention manuelle : qualification de leads entrants, enrichissement de contacts, séquences de relance, reporting pipeline hebdomadaire.

Le MCP HubSpot officiel, publié par HubSpot en 2026, expose sous forme standardisée l'accès en lecture/écriture aux contacts, companies, deals, tickets, engagements et campaigns via un OAuth contrôlé au scope près. Cette standardisation change la donne : là où une intégration Zapier ou Make demande un workflow linéaire par cas, un agent OpenClaw raisonne sur plusieurs étapes et peut gérer des branchements conditionnels complexes. Selon HubSpot Research (2024), un SDR moyen passe 28 % de sa semaine sur des tâches administratives non commerciales, dont la saisie CRM représente la majorité.

À la fin de cet article, vous saurez choisir entre les trois voies d'intégration OpenClaw ↔ HubSpot, configurer l'authentification sans fuite de credentials, déployer cinq workflows types, et anticiper les six erreurs qui font rater ce type de projet.

Points clés à retenir

Trois voies d'intégration coexistent en 2026 : MCP officiel HubSpot (recommandé), Composio (managé, 850+ apps), Jentic (multi-API).

L'agent accède à contacts, deals, companies, tickets, engagements et campaigns via scopes contrôlés — jamais plus que nécessaire.

Les 5 workflows types : qualification lead entrant, enrichissement, relance deals dormants, tagging comportemental, reporting pipeline.

La conformité RGPD impose 3 règles incontournables : scopes minimaux, purge 30 jours, journal d'audit.

---

Pourquoi connecter OpenClaw à HubSpot

La question n'est pas « OpenClaw est-il meilleur que les workflows natifs HubSpot » — elle est différente. HubSpot propose depuis 2024 ses propres fonctionnalités IA (Breeze, Copilot, AI Assistant) bien pensées pour les tâches guidées. Mais ces outils imposent les workflows que HubSpot estime pertinents, pas nécessairement ceux que votre PME a besoin d'automatiser.

OpenClaw inverse ce rapport. C'est votre agent, qui tourne sur votre infrastructure (VPS OVH ou cloud de votre choix), qui se connecte à HubSpot via l'API officielle, et qui exécute les workflows que vous définissez en langage naturel. L'agent peut en parallèle lire votre boîte mail, parcourir une page LinkedIn (dans le respect des CGU), interroger votre base de données métier, puis décider d'ajouter une note au deal HubSpot ou de changer le lifecycle stage d'un contact. Cette orchestration cross-tool en un seul raisonnement est ce que ni Zapier ni HubSpot Breeze ne permettent aujourd'hui.

En 2026, la bascule tient à deux facteurs techniques précis. D'abord la publication par HubSpot d'un MCP server officiel (developers.hubspot.com/mcp) qui expose les objets CRM et les engagements sous un format standardisé, avec gestion OAuth native. Ensuite la maturité des modèles agentiques (Claude Opus 4.7, Kimi K2.6) qui tiennent des séquences de 100 à 300 tool calls sans perdre le fil. Ces deux éléments alignés rendent fiable un workflow qui aurait dérapé il y a douze mois.

---

Architecture technique : les 3 voies d'intégration

Une architecture qui tient en production doit faire un choix clair sur la voie d'accès à HubSpot. Trois options sont matures au printemps 2026, chacune avec un profil différent.

Voie 1 — MCP HubSpot officiel (recommandée par défaut). HubSpot a publié son propre serveur MCP en 2026. L'agent OpenClaw se connecte à un endpoint HTTPS géré par HubSpot, s'authentifie via OAuth sur une « User-level App » créée dans votre compte, et accède aux objets CRM selon les scopes validés par un admin. C'est la voie la plus stable, la plus propre côté gouvernance, et celle que HubSpot supportera à long terme. Limite : elle n'expose pas encore certains objets custom ni les Sensitive Data Properties, contrainte documentée sur developers.hubspot.com/mcp. Voie 2 — Composio (managé, multi-apps). Composio (composio.dev) propose un serveur MCP qui agrège 850+ SaaS dont HubSpot. L'intérêt tient à l'orchestration multi-outils : votre agent peut dans le même raisonnement lire HubSpot, écrire dans Notion, pinger Slack et mettre à jour Google Sheets via un seul endpoint. Composio est SOC 2 Type 2 compliant. Coût : environ 49 USD / mois au plan Pro. Utile quand votre stack dépasse HubSpot + 1 outil. Voie 3 — Self-hosted MCP (avancée, souveraine). Pour les PME soumises à des contraintes de souveraineté (santé, défense, secteur public), vous pouvez héberger le serveur MCP HubSpot sur votre VPS. Vous clonez le repo officiel, installez les dépendances Node, exposez l'endpoint via Traefik ou Caddy, et vous gérez l'OAuth vous-même. Temps d'installation initial : 4 à 6 heures. C'est la voie à privilégier quand l'hébergement doit rester en France et que le journal d'audit doit être sous contrôle complet.

Pour une majorité de PME B2B, la voie 1 (MCP officiel HubSpot) est le bon choix. Elle combine la fiabilité d'un service géré par l'éditeur, une conformité RGPD simple à documenter, et un coût marginal (elle est incluse dans les plans HubSpot à partir de Starter). Si votre stack comporte déjà Composio pour d'autres intégrations, restez sur Composio pour éviter la fragmentation.

---

Configuration pas à pas du MCP HubSpot

La configuration de la voie officielle prend environ 12 minutes sur un compte HubSpot Starter déjà existant. Voici les étapes précises.

Étape 1 — Créer une Private App HubSpot. Dans votre compte HubSpot, naviguer dans Settings → Integrations → Private Apps → Create private app. Donnez un nom explicite (par exemple « OpenClaw Agent »), ajoutez une description, puis passez à l'onglet « Scopes ». C'est l'étape la plus critique. Étape 2 — Sélectionner les scopes au plus juste. Principe de moindre privilège obligatoire. Pour un agent de qualification de leads et enrichissement, ajoutez uniquement : crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.deals.read, crm.objects.deals.write, crm.schemas.contacts.read. N'ajoutez jamais les scopes sensitive sauf nécessité métier documentée. Cliquez sur « Create app » et copiez le token (il n'apparaît qu'une seule fois). Étape 3 — Installer OpenClaw avec le plugin HubSpot. Sur votre environnement (local ou VPS), installez la dernière version d'OpenClaw (ollama launch openclaw ou via le script officiel). Dans le fichier ~/.openclaw/config.yaml, ajoutez la section HubSpot :

yaml
channels:
  hubspot:
    enabled: true
    auth:
      private_app_token: "${HUBSPOT_TOKEN}"
    scopes:
      - crm.objects.contacts
      - crm.objects.deals

Le token n'est jamais en clair dans le fichier. Stockez-le dans une variable d'environnement ou un secret manager (Doppler, 1Password CLI, ou AWS Secrets Manager selon votre stack).

Étape 4 — Tester la connexion. Lancez l'agent et envoyez une requête simple en langage naturel : « Liste les 5 derniers contacts créés dans HubSpot avec leur email et leur lifecycle stage. » Si la réponse arrive rapidement avec des données réelles, la connexion est opérationnelle. Étape 5 — Créer un SOUL.md adapté. C'est le fichier de personnalité qui dicte le comportement de l'agent sur HubSpot. Un bon SOUL.md pour un agent commercial PME B2B inclut : une description du périmètre (« tu gères uniquement les contacts en lifecycle stage MQL et SQL »), des règles de validation (« tu ne modifies jamais le deal stage sans confirmation humaine »), un ton de communication attendu (« français, direct, sans jargon »), et une politique de logging (« chaque action sur un deal est commentée avec un préfixe [openclaw] »). Étape 6 — Ajouter la supervision. Exposez les logs de l'agent sur un dashboard minimal (uptime-kuma ou netdata suffit en PME). Configurez une alerte Slack ou WhatsApp quand le nombre d'erreurs API dépasse 5 en 1 heure — c'est le signal d'un problème de scope ou de rate limit. ---

5 workflows OpenClaw + HubSpot types

Les cinq workflows ci-dessous couvrent l'essentiel des besoins d'une PME B2B. Chacun est décrit avec le trigger, l'action, et les points de vigilance.

Workflow 1 — Qualification automatique des leads entrants. Trigger : nouveau contact créé avec source « formulaire site ». Action : l'agent enrichit le contact (fonction, taille d'entreprise, secteur), vérifie qu'il correspond à l'ICP documenté, attribue un score, et pousse le résultat dans un champ custom icp_score. Si le score dépasse un seuil pré-défini, l'agent crée automatiquement une tâche assignée au commercial en charge de la zone. Le gain principal est le temps de qualification, qui passe d'une dizaine de minutes de travail humain par lead à un traitement quasi-instantané plus une validation humaine rapide. Workflow 2 — Enrichissement en cascade. Trigger : contact créé sans numéro de téléphone. Action : l'agent interroge Dropcontact d'abord (base européenne RGPD-native), puis Apollo en fallback si pas de match, et met à jour le contact dans HubSpot avec les données trouvées. Intérêt de la cascade : les bases américaines et européennes couvrent des segments différents, donc enrichir dans l'ordre EU-native puis US permet de conserver la conformité là où c'est possible. Workflow 3 — Relance intelligente des deals dormants. Trigger : deal en stage « Discovery » sans activité depuis 14 jours. Action : l'agent lit les derniers emails échangés sur le deal, identifie le bon angle de relance (question technique non résolue, demande de devis en attente, référence client sectorielle), rédige un email personnalisé de relance, et crée une tâche « Relance à valider » pour le commercial. L'humain relit, ajuste si besoin, et envoie — l'agent n'envoie jamais seul. Workflow 4 — Tagging comportemental cross-canal. Trigger : contact a ouvert 3 emails + visité le pricing + téléchargé une étude de cas. Action : l'agent ajoute le tag « hot_prospect » au contact, change le lifecycle stage à « SQL », crée un deal en stage « Discovery », et notifie le commercial sur Slack. Workflow purement additif sur les signaux déjà captés par HubSpot, mais qui exploite la règle cross-canal que les automations natives peinent à gérer. Workflow 5 — Reporting pipeline hebdomadaire. Trigger : chaque lundi 8h. Action : l'agent extrait les métriques pipeline de la semaine (nouveaux deals, deals avancés en stage, deals perdus avec motif), croise avec les données de la semaine précédente, identifie les variations anormales (un stage qui se vide, un commercial qui perd plusieurs deals d'affilée), rédige un récap en 400 mots et le poste dans un canal Slack dédié. Économie : plusieurs heures par semaine de reporting manuel du responsable commercial. ---

Sécurité, RGPD et gouvernance des données

La conformité d'un agent qui lit et écrit dans un CRM est un sujet qui se traite dès le jour un, pas après une première alerte CNIL.

Règle 1 — Scopes au plus juste. L'agent ne doit jamais avoir accès aux scopes sensitive (santé, données financières sensibles au sens RGPD) sauf nécessité métier explicite. Chaque scope ajouté doit être justifié dans un registre écrit. Pour un agent de qualification commercial standard, 4 à 6 scopes suffisent. Règle 2 — Journal d'audit immuable. Chaque action de l'agent sur HubSpot doit être tracée : quel objet modifié, quand, avec quelle valeur avant/après, et sur quel raisonnement. Le journal est stocké en append-only (typiquement un fichier CSV quotidien ou une table Supabase avec RLS) et conservé 24 mois minimum. C'est ce journal qui vous protège en cas de question CNIL ou de litige client. Règle 3 — Purge 30 jours des contextes sensibles. Les prompts et réponses qui transitent par l'agent peuvent contenir des données personnelles (nom, email, numéro, contenu de deals). Vous devez documenter une politique de purge : les logs contenant des PII sont supprimés au bout de 30 jours, à l'exception du journal d'audit qui ne contient que des méta-données (objet, date, action, sans le contenu détaillé). Règle 4 — Révocation immédiate possible. Le token de la Private App HubSpot doit pouvoir être révoqué en 1 clic. Documentez cette procédure dans un runbook et testez-la tous les 6 mois.

Selon la CNIL (doctrine prospection commerciale 2024), un agent IA qui traite des données prospects est considéré comme un sous-traitant au sens de l'article 28 RGPD. Le contrat entre votre PME et OpenClaw (ou son hébergeur) doit être formalisé si l'agent tourne en SaaS externe. S'il tourne sur votre VPS, vous êtes responsable de traitement unique.

---

Debugging : les 6 erreurs les plus fréquentes

Erreur 1 — Scopes insuffisants au premier run. L'agent se connecte mais retourne « 403 Forbidden » sur la première écriture. Corriger : revenir dans la Private App HubSpot, ajouter le scope manquant, régénérer le token, mettre à jour la variable d'environnement, relancer l'agent. Les messages d'erreur HubSpot indiquent précisément le scope manquant. Erreur 2 — Rate limits dépassés. HubSpot Starter limite à 100 requêtes API par 10 secondes par Private App. Un agent qui traite 50 contacts en parallèle peut dépasser. Corriger : ajouter une file d'attente dans OpenClaw (config rate_limit: 90/10s) qui sérialise les appels. Erreur 3 — Token en clair dans le repo Git. Erreur classique. Le jour où le repo devient public par erreur, le token est compromis. Corriger : toujours stocker les secrets dans un gestionnaire (Doppler, 1Password CLI, AWS Secrets Manager) et ne jamais commiter le fichier .env. Ajoutez .env et config.yaml au .gitignore dès l'initialisation du repo. Erreur 4 — Boucle infinie sur webhook HubSpot. Vous configurez un webhook HubSpot qui déclenche OpenClaw à chaque modification de contact. L'agent met à jour le contact. HubSpot redéclenche le webhook. L'agent remodifie. Boucle. Corriger : soit filtrer le webhook sur source != "openclaw", soit ajouter un tag technique que l'agent ignore, soit désactiver le webhook pour les modifications faites par la Private App. Erreur 5 — Association manquante entre contact et company. L'agent qualifie un lead, mais ne trouve pas la company associée. Cause : en HubSpot, l'association n'est pas automatique quand on crée un contact par API. Corriger : ajouter dans le workflow un step create_association qui lie contact ↔ company si la company existe déjà, ou la crée puis la lie si pas de correspondance par domaine. Erreur 6 — Silent fail sur les custom properties. Vous écrivez dans un champ custom qui n'existe pas. HubSpot retourne un 200 OK mais ignore la valeur. Corriger : avant chaque write, interroger le schéma du CRM (crm.schemas.contacts.read) et vérifier que la property existe. Si non, la créer via l'API Properties ou logger une alerte. ---

Foire aux questions

OpenClaw peut-il mettre à jour mon CRM HubSpot en temps réel ?

Oui, avec deux modalités. Pour du « quasi temps réel » (latence de 15 secondes à 2 minutes), l'agent tourne en polling : il interroge HubSpot toutes les N minutes pour détecter les nouveaux contacts ou deals et réagit. Pour du temps réel strict (latence inférieure à 5 secondes), on configure un webhook HubSpot qui pousse les événements vers OpenClaw. Les deux approches fonctionnent. Le polling est plus simple à débugger, le webhook est plus économe en API calls si votre volume dépasse 500 événements par jour.

Quel est le coût mensuel type de la stack OpenClaw + HubSpot pour une PME ?

Le coût se décompose en quatre postes à additionner selon votre usage : l'abonnement HubSpot (à partir de Starter), un VPS si vous auto-hébergez (VPS OVH Value à partir de quelques euros/mois), l'API du modèle (Claude Sonnet ou Kimi K2.6, tarification au token), et éventuellement l'enrichissement (Dropcontact, Apollo). Pour un agent qui traite quelques centaines de contacts qualifiés par mois, l'enveloppe reste typiquement dans la fourchette basse à intermediaire des outils SaaS d'automatisation. Faites la simulation en fonction de votre volume réel avant de signer.

Comment gérer la conformité RGPD quand un agent IA accède à mes contacts HubSpot ?

Trois règles incontournables : des scopes au plus juste (jamais sensitive sauf nécessité documentée), un journal d'audit immuable conservé 24 mois, et une politique de purge à 30 jours des logs contenant des PII. Si l'agent tourne sur votre VPS, vous êtes responsable de traitement unique. Si vous passez par Composio ou Jentic, un contrat de sous-traitance au sens de l'article 28 RGPD doit être signé. Pour une PME B2B standard, ces trois règles couvrent l'essentiel des obligations.

OpenClaw + HubSpot est-il plus puissant que Zapier ou Make ?

Sur les workflows linéaires simples (« si X alors Y »), Zapier et Make sont plus rapides à configurer et tout aussi fiables. OpenClaw gagne dès que le workflow demande du raisonnement (analyser le contenu d'un email, décider d'un angle de relance, croiser plusieurs signaux) ou un enchaînement de plus de 5 étapes conditionnelles. Typiquement, 1 workflow OpenClaw remplace plusieurs Zaps équivalents, avec une capacité d'adaptation que Zapier n'a pas.

Faut-il un développeur pour installer cette intégration ?

Pour la voie 1 (MCP HubSpot officiel) et la voie 2 (Composio), non. Un·e responsable ops à l'aise avec la ligne de commande peut installer et configurer l'agent en 2 à 4 heures. Pour la voie 3 (self-hosted sur VPS), oui, un profil tech est nécessaire à l'installation mais pas à la maintenance courante une fois l'agent en production.

---

Pour aller plus loin

Un agent HubSpot ne vit pas seul. Pour comprendre comment il s'articule dans une machine d'acquisition B2B plus large, notre guide Kimi K2.6 détaille le modèle open-weight qui change les coûts, et notre guide Kimi + OpenClaw pour agents autonomes approfondit la partie infrastructure.

Côté commercial, nos articles sur les agents IA pour le SEO et le GEO et sur les agents IA LinkedIn B2B couvrent les briques complémentaires à votre CRM.

Chez OKB, on déploie ce type de stack en mode embarqué (on forme votre équipe) ou en mode managé (on opère pour vous). Réservez un appel stratégique pour qu'on étudie votre cas.

---

Sources

HubSpot Developers, *Model Context Protocol server documentation*, 2026 (documentation officielle)

Anthropic, *Model Context Protocol specification*, 2024-2026

Composio, *HubSpot toolkit for OpenClaw*, 2026

HubSpot, *Developer API overview*, documentation de référence

Anthropic, *Claude MCP documentation*, 2025-2026

CNIL, *Guide prospection commerciale B2B*, doctrine actualisée 2024