Tutoriels 25

Tutoriel 25 — OpenClaw Skill API Gateway : connectez Slack, HubSpot et 100+ autres services sans configuration OAuth (2026)

Objectif : installer le Skill API Gateway pour qu'OpenClaw se connecte à Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot et 100+ autres services sans avoir à obtenir vos propres identifiants OAuth.


La valeur fondamentale d'API Gateway

Connecter OpenClaw à des services sans avoir à obtenir sa propre clé est le principal atout du Skill API Gateway.

Approche traditionnelle : pour qu'OpenClaw envoie un message Slack, il faut aller dans le back-office développeur de Slack, créer une App, obtenir des identifiants OAuth, configurer les URL de callback, sauvegarder le token... Au minimum 30 minutes de configuration, avec de nombreuses possibilités d'erreur.

Approche API Gateway : installer le Skill → cliquer sur le lien d'autorisation → c'est terminé. Les identifiants OAuth sont gérés de façon centralisée par le cloud API Gateway — une seule autorisation en un clic suffit.


Les 100+ services supportés par catégorie

Catégorie Services
Communication / Collaboration Slack, Microsoft Teams, Discord, Gmail, Outlook
Gestion de projet Notion, Trello, Asana, Linear, Jira, Basecamp
CRM / Ventes HubSpot, Salesforce, Pipedrive, Zoho CRM
Données / Tableaux Airtable, Google Sheets, Smartsheet, Coda
Stockage cloud Google Drive, Dropbox, OneDrive, Box
Outils de développement GitHub, GitLab, Bitbucket, Vercel, Netlify
Calendrier Google Calendar, Outlook Calendar, Calendly
E-commerce / Paiement Shopify, Stripe, WooCommerce

La liste complète des services supportés peut être consultée après installation avec /api-gateway list.


Étape 1 : Installer le Skill

/install @byungkyu/api-gateway

Vérification :

pnpm openclaw skills list
# Le Skill api-gateway devrait apparaître

Étape 2 : Autoriser votre premier service (exemple Slack)

Voici le processus complet pour connecter Slack et envoyer des messages sans configuration :

1. Déclencher le flux d'autorisation :

/api-gateway auth slack

2. OpenClaw renvoie un lien d'autorisation :

Veuillez cliquer sur le lien suivant pour compléter l'autorisation Slack :
https://gateway.clawhub.io/auth/slack?token=xxxx&callback=openclaw

3. Ouvrez le lien dans le navigateur, connectez-vous à votre compte Slack et cliquez sur "Autoriser".

4. La page retourne sur OpenClaw avec :

Autorisation Slack réussie ! Espace de travail : Nom-de-votre-équipe
Permissions disponibles : envoyer des messages, lire la liste des canaux, téléverser des fichiers

Les informations d'autorisation sont chiffrées et stockées sur le cloud API Gateway. OpenClaw ne conserve localement qu'un token d'accès à courte durée de vie, rafraîchi automatiquement — aucune nouvelle autorisation requise.


Étape 3 : Exemples d'envoi de messages Slack

Après autorisation, opérez directement en langage naturel :

Envoie un message Slack au canal #général :
"Réunion plénière vendredi après-midi à 15h — merci de confirmer votre présence."

Ou avec une commande structurée :

/api-gateway slack send-message --channel général --text "Réunion plénière vendredi, merci de confirmer"

Envoyer un message privé :

Envoie un message privé Slack à @marie.dupont : j'ai examiné le design — quelques points à ajuster. Tu es disponible cet après-midi ?

Étape 4 : Exemples de lecture de données Airtable

Tutoriel openclaw pour opérer une base de données Airtable avec l'IA — autorisez d'abord :

/api-gateway auth airtable

Après autorisation, interrogez les données :

Lis dans la table "Suivi clients" d'Airtable tous les enregistrements au statut "À contacter",
liste le nom du client, le contact, la date du dernier suivi

Ajouter un nouvel enregistrement :

Ajoute un nouvel enregistrement dans la table "Suivi clients" d'Airtable :
Nom client : Dupont Technologies, Contact : M. Dupont, Statut : Premier contact, Date de suivi : 2026-03-30

Étape 5 : Exemples d'opérations HubSpot CRM

Cas d'usage courants pour l'automatisation CRM HubSpot avec openclaw :

Rechercher un contact :

/api-gateway hubspot search-contact --email dupont@exemple.fr

Créer une tâche de suivi :

Dans HubSpot, crée une tâche de suivi pour le contact dupont@exemple.fr :
Contenu : envoyer la proposition produit T1, date d'échéance : 2026-04-05

Mise à jour en masse des statuts de leads (combiné avec analyse IA) :

Récupère tous les nouveaux leads du mois dans HubSpot, classe-les par taille d'entreprise,
et change le statut des leads avec plus de 500 employés en "Priorité haute"

Étape 6 : API Gateway vs configuration directe MCP

OAuth sans avoir à obtenir sa propre clé est l'avantage principal d'API Gateway, mais les deux approches ont leurs cas d'usage :

Cas Approche recommandée
Connexion rapide à des SaaS standards (Slack, HubSpot, etc.) API Gateway
Portée de permissions personnalisée ou services intranet Configuration MCP directe
L'entreprise a sa propre App OAuth, besoin d'une App indépendante Configuration MCP directe
Utilisateur individuel, pas de gestion de clé API API Gateway
Exigences très élevées en sécurité des données, aucun identifiant ne doit transiter par un tiers Configuration MCP directe

Questions fréquentes

Quelle est la différence entre le Skill API Gateway et la configuration directe MCP ?

Le Skill API Gateway délègue la gestion des identifiants OAuth à la passerelle cloud de ClawHub — vous n'avez pas à créer vos propres Apps ni à sauvegarder des tokens. C'est idéal pour une connexion rapide aux principaux SaaS. La configuration MCP directe nécessite de créer vous-même une application développeur sur la plateforme concernée, d'obtenir vos propres identifiants et de les saisir manuellement dans le fichier de configuration OpenClaw — plus fastidieux mais entièrement sous votre contrôle. C'est adapté pour les services internes ou pour les cas où la souveraineté des données est primordiale. Fonctionnellement équivalentes, la différence porte sur qui gère les identifiants.

Faut-il un compte entreprise pour connecter Slack avec API Gateway ?

Non — les comptes Slack personnels ou petites équipes (gratuits) fonctionnent aussi bien. API Gateway utilise le flux OAuth officiel de Slack, indépendant du type de compte. La seule limitation est que la version gratuite de Slack limite l'historique des messages à 90 jours — c'est une contrainte de Slack elle-même, sans lien avec API Gateway. Les comptes payants n'ont pas cette limitation.

Où sont stockées les informations d'autorisation ? Sont-elles sécurisées ?

L'access token OAuth est chiffré et stocké sur les serveurs API Gateway de ClawHub avec chiffrement AES-256. OpenClaw ne met en cache localement qu'un token à courte durée de vie (1 heure par défaut). ClawHub ne lit ni n'enregistre le contenu des données métier transmises via API Gateway — il gère uniquement le renouvellement et le relais des identifiants. Si vous révoquez l'autorisation dans les paramètres de votre compte ClawHub, le token du service concerné est immédiatement invalidé.

API Gateway gère-t-il les limitations d'appels des services ?

Oui. API Gateway intègre un Rate Limit Guard — quand il détecte une approche de la limite de fréquence d'appels d'un service, il met automatiquement les requêtes en file et ralentit leur traitement, tout en affichant l'utilisation du quota dans la conversation OpenClaw. Par exemple, HubSpot version gratuite autorise 250 appels API par jour — API Gateway enverra une alerte quand il reste 50 appels, pour éviter une interruption de service par dépassement.


Prochaines étapes

  • Tutoriel 26 — Utilisez Agent Browser pour traiter les pages nécessitant une connexion ou un rendu JavaScript
  • Tutoriel 24 — Encapsulez votre flux d'automatisation en Skill et publiez-le sur ClawHub

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注