OpenClaw par SMS

Le SMS est le canal le plus simple d’OpenClaw : une extension officielle, installée séparément, qui reçoit et envoie des SMS et MMS via un numéro Twilio ou un service de messagerie. La passerelle enregistre une route de webhook, valide par défaut les signatures des requêtes Twilio, répond via l’API de messages et enregistre les rappels de livraison ; ce sont des messages privés seulement. La configuration est courte. Ce que les gens manquent, c’est que tout peut être correctement configuré et que les opérateurs américains peuvent quand même ne rien livrer, à cause d’un enregistrement qui n’a rien à voir avec OpenClaw. Voici ce qu’il vous faut, la configuration, la règle du webhook, et cet enregistrement.

Ce qu’il vous faut

• L’extension, installée depuis son paquet ; un compte Twilio avec un numéro capable de SMS, capable de MMS si vous voulez des pièces jointes, ou un service de messagerie ; le SID du compte et le jeton d’authentification.
• Une URL HTTPS publique qui atteint la passerelle, parce que Twilio livre les messages en l’appelant.
• Une politique d’expéditeur : l’appairage par défaut pour un usage privé, une liste d’autorisation de numéros préapprouvés, ou ouvert seulement pour un accès public voulu.
• Un même numéro Twilio peut servir les SMS et les appels vocaux s’il a les deux capacités ; les deux webhooks se configurent séparément et utilisent des chemins de passerelle distincts.

C’est distinct de la configuration du canal OpenClaw : la validation des signatures de webhook, l’appairage et les identifiants sortants peuvent tous être corrects pendant que les opérateurs bloquent ou filtrent encore la livraison.

La configuration

Installez l’extension, choisissez l’expéditeur dans Twilio et notez le SID, le jeton et le numéro ou le SID du service de messagerie. Écrivez la configuration du canal, activé, les identifiants, le numéro d’origine, l’URL publique du webhook et la politique de messages privés, et appliquez-la par un correctif de configuration après un essai à blanc. Dans les réglages de messagerie du numéro, pointez le webhook des messages entrants vers le chemin SMS de la passerelle avec la méthode POST ; le chemin peut être changé dans la configuration. Exposez ensuite exactement ce chemin à l’URL publique : la même route sert les webhooks entrants et les pièces jointes éphémères à jeton qu’OpenClaw distribue quand il envoie des MMS, et la documentation montre un funnel Tailscale limité à ce seul chemin pour les tests locaux.

L’enregistrement américain

• Les SMS et MMS envoyés par une application depuis un numéro local américain vers des destinataires américains exigent l’enregistrement A2P 10DLC ; les numéros gratuits et les codes courts ont leur propre vérification. Les comptes d’essai ne peuvent pas s’enregistrer.
• Avant de compter sur un tel expéditeur, confirmez dans Twilio qu’un profil de conformité est approuvé, que la marque et la campagne sont enregistrées, que le numéro est enregistré et dans le groupe d’expéditeurs du service approuvé, que la campagne décrit le vrai cas d’usage avec des messages d’exemple correspondants, et que chaque parcours d’adhésion est documenté avec des preuves publiques.
• Le consentement doit être volontaire et distinct des conditions de service ou de l’achat, avec les mentions que Twilio exige, la preuve du consentement conservée, les mots-clés de désabonnement standard respectés, et une seule confirmation après un désabonnement ; la documentation liste les trois codes de rejet et ce que chacun signifie.

Un numéro de téléphone pour les appels vocaux OpenClaw est le versant vocal du même numéro Twilio, et OpenClaw sur WhatsApp le canal que la plupart des gens choisissent quand l’enregistrement SMS est plus qu’ils ne veulent.

Le chemin public

Le webhook est le seul endroit où le SMS exige que la passerelle soit joignable de l’extérieur, et la documentation le limite au seul chemin plutôt qu’à tout le port. OpenClaw et Tailscale explique le funnel qui fait cela, et la page de sécurité couvre l’exposition des webhooks et les contrôles d’expéditeurs.

Sur Diali

Le SMS est l’un des canaux connectables sur Diali : le compte Twilio, le numéro et l’enregistrement restent à vous, l’extension, le chemin du webhook et la passerelle sont à nous. Le SMS sur Diali est la page du canal et OpenClaw hébergé sur Diali l’assistant.

• Un numéro Twilio ou un service de messagerie, un chemin de webhook, l’appairage par défaut.
• Exposez le chemin, pas le port.
• La livraison aux États-Unis exige l’A2P 10DLC, et c’est la barrière de Twilio, pas celle d’OpenClaw.