🩞
Integration de canal

Connecter OpenClaw a iMessage

Utilisez votre assistant IA directement via Apple Messages sur macOS. Prend en charge iMessage et SMS.

macOS uniquement

L'integration iMessage necessite macOS avec l'app Messages configuree. Elle utilise l'outil CLI imsg pour lire la base de donnees Messages locale.

Pourquoi utiliser iMessage ?
  • +Integration Apple native — Fonctionne avec votre app Messages existante
  • +iMessage + SMS — Prend en charge les deux protocoles de facon transparente
  • +Accuses de reception — Sachez quand les messages sont livres et lus
  • +Reactions — Les reactions iMessage sont prises en charge
  • +Discussions de groupe — Participez aux conversations de groupe
  • +Gateway distant — Peut fonctionner via SSH vers un Mac distant
Prerequis
  • 1.
    macOS

    Avec l'app Messages configuree et connectee a votre identifiant Apple

  • 2.
    Autorisation d'acces complet au disque

    Requise pour qu'OpenClaw puisse lire ~/Library/Messages/chat.db

  • 3.
    CLI imsg

    Outil en ligne de commande pour interagir avec Messages

Etapes de configuration

1

Installer le CLI imsg

Installez l'outil en ligne de commande imsg qu'OpenClaw utilise pour interagir avec Messages :

brew install imsg

Ou telechargez depuis la page des releases GitHub d'imsg

2

Accorder l'acces complet au disque

OpenClaw a besoin de la permission de lire la base de donnees Messages :

  • - Ouvrez Reglages Systeme (ou Preferences Systeme)
  • - Allez dans Confidentialite et securite > Acces complet au disque
  • - Cliquez sur le bouton + et ajoutez Terminal (ou iTerm)
  • - Ajoutez egalement l'executable OpenClaw si vous l'executez en tant que binaire
3

Configurer OpenClaw

Ajoutez la configuration iMessage a votre fichier de configuration openclaw.json :

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "allowFrom": ["+15555550123", "user@example.com"]
    }
  }
}
4

Configurer allowFrom

Specifiez qui peut interagir avec votre bot :

  • - Numeros de telephone avec indicatif pays : +33612345678
  • - Identifiants Apple (adresses email) : utilisateur@exemple.com
5

Tester la connexion

Verifiez que le canal iMessage fonctionne :

openclaw channels status imessage

Puis envoyez un message depuis un contact autorise pour tester l'integration.

Configuration avancee

Options de configuration completes pour le canal iMessage :

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "remoteHost": "user@gateway-host",
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123", "user@example.com"],
      "historyLimit": 50,
      "includeAttachments": false,
      "mediaMaxMb": 16,
      "service": "auto",
      "region": "US"
    }
  }
}
  • cliPath — Chemin vers l'executable CLI imsg
  • dbPath — Chemin vers la base de donnees Messages
  • remoteHost — Hote SSH pour la configuration du gateway distant
  • dmPolicy — Comment gerer les messages prives
  • allowFrom — Numeros de telephone ou identifiants Apple autorises a envoyer des messages
  • historyLimit — Nombre de messages a inclure comme contexte
  • includeAttachments — Activer la gestion des pieces jointes
  • mediaMaxMb — Taille maximale des pieces jointes en Mo
  • service — Forcer iMessage ou SMS, ou utiliser auto
  • region — Region pour le formatage des numeros de telephone
Configuration du Gateway distant (Optionnel)

Si vous voulez executer OpenClaw sur un serveur mais acceder a iMessage depuis un Mac a la maison, vous pouvez utiliser SSH :

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - Assurez-vous que l'authentification par cle SSH est configuree
  • - Le Mac doit etre toujours allume et connecte
  • - imsg et l'acces complet au disque doivent etre configures sur le Mac
Fonctionnalites prises en charge
OKAccuses de reception
OKReactions iMessage
OKDiscussions de groupe
OKSupport SMS
OPTPieces jointes (optionnel)
OKHistorique des messages
Depannage

Permission refusee lors de la lecture de chat.db ?

Assurez-vous d'avoir accorde l'acces complet au disque a Terminal/iTerm et a l'executable OpenClaw. Vous devrez peut-etre redemarrer le terminal apres avoir accorde l'acces.

Le bot ne repond pas aux messages ?

Verifiez que le numero de telephone ou l'identifiant Apple dans allowFrom correspond exactement. Les numeros de telephone necessitent le + et l'indicatif pays.

Impossible de trouver chat.db ?

Le chemin par defaut est ~/Library/Messages/chat.db. Assurez-vous que l'app Messages a ete ouverte au moins une fois et que vous etes connecte.

Commande imsg introuvable ?

Assurez-vous qu'imsg est installe et dans votre PATH. Vous pouvez specifier le chemin complet dans cliPath.

Le gateway distant ne se connecte pas ?

Verifiez que l'authentification par cle SSH fonctionne avec ssh user@host et que le Mac distant a imsg installe avec l'acces complet au disque.

iMessage connecte !

Ajoutez d'autres canaux ou configurez des competences pour personnaliser votre assistant IA.

Ajouter WhatsAppExplorer les competences