Aller au contenu
Guides

Passer l’iMessage d’OpenClaw de BlueBubbles à imsg

Ce que la CLI remplace, la liste de migration, la traduction de configuration clé par clé, et les vérifications avant la bascule

6 min de lecture

La prise en charge de BlueBubbles a été retirée d’OpenClaw, et iMessage ne fonctionne plus que par l’extension iMessage officielle, qui pilote l’outil en ligne de commande imsg en JSON-RPC et atteint la même surface d’API privée que BlueBubbles : réactions, modifications, annulations d’envoi, réponses en fil, envoi avec effet, sondages natifs, gestion des groupes et pièces jointes. Un seul binaire CLI remplace le serveur, l’application cliente et la plomberie des webhooks. La documentation donne un guide de migration depuis une ancienne configuration BlueBubbles, le seul chemin pris en charge, et note qu’un bloc BlueBubbles résiduel est inerte sur l’OpenClaw actuel. Voici la liste, ce qu’imsg fait, les vérifications préalables, et la traduction de configuration.

La liste

  • Installez l’extension officielle et vérifiez le résultat de l’application, vérifiez imsg directement sur le Mac qui fait tourner Messages avec les commandes de discussions, d’historique, d’envoi et d’aide RPC, copiez les clés de comportement de l’ancien bloc vers le nouveau, politique des messages privés, liste d’autorisation, politique de groupe, liste de groupe, groupes, inclusion des pièces jointes, racines de pièces jointes, plafond de médias, limite de morceaux de texte et actions, et abandonnez les clés de transport qui n’existent plus, l’URL du serveur, le mot de passe et les URL de webhooks.
  • Si la passerelle n’est pas sur le Mac de Messages, fixez le chemin de la CLI au chemin absolu local à la passerelle d’une enveloppe SSH, gardez le chemin de la base absolu sur ce Mac, et fixez l’hôte distant pour les enveloppes complexes, puisqu’OpenClaw ne détecte automatiquement que la forme d’enveloppe transparente simple.
  • Activez le bloc iMessage, sondez l’état du canal, qui se recharge à chaud et exige une passerelle en cours, puis testez un message privé, un groupe autorisé, les pièces jointes si elles sont activées, et chaque action d’API privée que l’agent utilisera, avant de supprimer le serveur BlueBubbles et l’ancien bloc.
  • imsg distant à la version que nomme la documentation a deux limites RPC étroites : les votes de sondages doivent utiliser l’identifiant d’option plutôt qu’un index ou un texte, et les réponses avec pièce jointe ne peuvent pas cibler un index de partie de message non nul ; le comportement local est inchangé.
Un seul binaire CLI remplace le serveur BlueBubbles, l’application cliente et la plomberie des webhooks : pas de point d’accès REST, pas d’authentification de webhook.

Ce qu’imsg fait

imsg est une CLI macOS locale pour Messages : OpenClaw démarre son mode RPC comme processus enfant et parle JSON-RPC sur l’entrée et la sortie standard, sans serveur HTTP, URL de webhook, démon, agent de lancement ni port. Les lectures viennent de la base de discussions de Messages par un accès SQLite en lecture seule, les messages entrants en direct viennent d’une commande de surveillance qui suit les événements du système de fichiers avec un repli par sondage, les envois utilisent l’automatisation de Messages pour le texte et les fichiers, et les actions avancées utilisent une commande de lancement qui injecte l’assistant imsg dans Messages, ce qui débloque les accusés de lecture, les indicateurs de frappe, les envois riches, la modification, l’annulation d’envoi, les réponses en fil, les tapbacks, les sondages et la gestion des groupes. Les versions Linux peuvent inspecter une base copiée mais ne peuvent ni envoyer, ni surveiller, ni piloter Messages, donc pour OpenClaw la CLI tourne sur le Mac connecté ou par une enveloppe SSH vers lui. Avant de changer la configuration, installez ou mettez à jour imsg avec Homebrew, accordez l’accès complet au disque au processus parent qui le lance quand la commande des discussions n’arrive pas à ouvrir la base, vérifiez la lecture, la surveillance, l’envoi et le RPC par la même enveloppe ou le même contexte d’utilisateur qu’OpenClaw utilisera, surveillez l’erreur d’automatisation qui signifie que la permission a atterri sur l’enveloppe de génération de clés SSH, activez le pont d’API privée avec la commande de lancement, qui exige SIP désactivé, et après avoir activé le canal confirmez que la sonde rapporte le compte fonctionnel avec l’API privée disponible ; prenez d’abord un instantané du fichier de configuration.

La table de traduction

  • Les clés de comportement gardent leurs noms et leur sens : activation, politique des messages privés avec l’appairage par défaut, liste d’autorisation avec les mêmes formats d’identifiants bien que les approbations du magasin d’appairage ne se transfèrent pas, politique de groupe avec la liste par défaut, liste de groupe où une liste explicitement vide bloque tous les groupes, groupes où l’entrée joker se copie telle quelle tandis que les entrées par groupe sont réindexées par identifiant numérique de discussion, accusés de lecture, inclusion des pièces jointes qui reste désactivée par défaut et abandonne en silence les médias entrants tant qu’elle n’est pas fixée, racines de pièces jointes, et plafond de médias, dont le défaut iMessage est de seize mégaoctets contre huit pour BlueBubbles.
  • Les clés de transport sont retirées, l’URL du serveur et le mot de passe, et trois nouvelles apparaissent : le chemin de la CLI, la surcharge du chemin de la base qui pour SSH est un chemin absolu sur le Mac de Messages jamais développé contre le dossier personnel de la passerelle, et l’hôte distant sous forme d’hôte ou d’utilisateur arobase hôte, qui active les récupérations de pièces jointes entrantes et la mise en attente sortante réservée au propriétaire par SSH et SCP stricts avec un nettoyage au mieux qui avertit en cas d’échec, plus des racines de pièces jointes distantes utilisées seulement dans ce mode.
  • Le piège du registre des groupes : BlueBubbles indexait les groupes autrement, donc les entrées par groupe doivent être réindexées par l’identifiant numérique de discussion iMessage de la commande des discussions, et un groupe qui fonctionnait avant restera silencieusement sans correspondance tant que ce n’est pas fait.

OpenClaw sur iMessage est le billet du canal sur lequel la migration atterrit, et Activer l’API privée d’imsg le pont dont dépendent la plupart des actions copiées.

Sur Diali

iMessage ne fait pas partie des canaux que Diali connecte aujourd’hui : WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et voix. Connecter votre premier canal en cinq minutes explique comment ceux-là sont reliés, et La sécurité chez Diali la frontière qui s’applique à chacun.

Pourquoi ce changement

Retirer un serveur, une application cliente et un webhook du chemin enlève trois identifiants et un point d’accès exposé du tableau ; ce qui reste est un binaire sur un Mac auquel vous confiez déjà vos messages. OpenClaw hébergé sur Diali est l’assistant et Les extensions d’OpenClaw la surface par laquelle l’extension iMessage officielle s’installe.

  • Un binaire en JSON-RPC, pas de serveur, pas de webhook.
  • Les clés de comportement se copient ; les clés de transport disparaissent ; les groupes se réindexent.
  • Vérifier imsg d’abord, basculer ensuite, supprimer en dernier.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.