🩞
Kanal-Integration

OpenClaw mit iMessage verbinden

Nutze deinen KI-Assistenten direkt ueber Apple Messages auf macOS. Unterstuetzt sowohl iMessage als auch SMS.

Nur macOS

Die iMessage-Integration erfordert macOS mit konfigurierter Messages-App. Sie verwendet das imsg-CLI-Tool zum Lesen aus der lokalen Messages-Datenbank.

Warum iMessage nutzen?
  • +Native Apple-Integration — Funktioniert mit deiner bestehenden Messages-App
  • +iMessage + SMS — Unterstuetzt beide Protokolle nahtlos
  • +Lesebestaetigungen — Wisse, wann Nachrichten zugestellt und gelesen wurden
  • +Reaktionen — iMessage-Reaktionen werden unterstuetzt
  • +Gruppenchats — An Gruppengespraechen teilnehmen
  • +Remote-Gateway — Kann ueber SSH zu einem entfernten Mac funktionieren
Voraussetzungen
  • 1.
    macOS

    Mit konfigurierter Messages-App und angemeldeter Apple ID

  • 2.
    Vollstaendiger Festplattenzugriff

    Erforderlich, damit OpenClaw ~/Library/Messages/chat.db lesen kann

  • 3.
    imsg CLI

    Kommandozeilenwerkzeug zur Interaktion mit Messages

Einrichtungsschritte

1

imsg CLI installieren

Installiere das imsg-Kommandozeilentool, das OpenClaw zur Interaktion mit Messages verwendet:

brew install imsg

Oder lade es von der imsg-GitHub-Releases-Seite herunter

2

Vollstaendigen Festplattenzugriff gewaehren

OpenClaw benoetigt die Berechtigung, die Messages-Datenbank zu lesen:

  • - Oeffne Systemeinstellungen
  • - Gehe zu Datenschutz & Sicherheit > Vollstaendiger Festplattenzugriff
  • - Klicke auf die + Schaltflaeche und fuege Terminal (oder iTerm) hinzu
  • - Fuege auch die OpenClaw-Ausfuehrungsdatei hinzu, wenn sie als Binary laeuft
3

OpenClaw konfigurieren

Fuege die iMessage-Konfiguration zu deiner openclaw.json-Konfigurationsdatei hinzu:

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

allowFrom einrichten

Lege fest, wer mit deinem Bot interagieren kann:

  • - Telefonnummern mit Laendervorwahl: +15555550123
  • - Apple IDs (E-Mail-Adressen): user@example.com
5

Verbindung testen

Verifiziere, dass der iMessage-Kanal funktioniert:

openclaw channels status imessage

Sende dann eine Nachricht von einem erlaubten Kontakt, um die Integration zu testen.

Erweiterte Konfiguration

Vollstaendige Konfigurationsoptionen fuer den iMessage-Kanal:

{
  "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 — Pfad zur imsg-CLI-Ausfuehrungsdatei
  • dbPath — Pfad zur Messages-Datenbank
  • remoteHost — SSH-Host fuer Remote-Gateway-Einrichtung
  • dmPolicy — Wie Direktnachrichten behandelt werden
  • allowFrom — Telefonnummern oder Apple IDs, die schreiben duerfen
  • historyLimit — Anzahl der Nachrichten fuer Kontext einbeziehen
  • includeAttachments — Anhangsverarbeitung aktivieren
  • mediaMaxMb — Maximale Anhangsgroesse in MB
  • service — iMessage oder SMS erzwingen, oder auto verwenden
  • region — Region fuer Telefonnummernformatierung
Remote-Gateway-Einrichtung (Optional)

Wenn du OpenClaw auf einem Server ausfuehren, aber von einem Mac zu Hause auf iMessage zugreifen moechtest, kannst du SSH verwenden:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - Stelle sicher, dass SSH-Schluessel-Authentifizierung eingerichtet ist
  • - Der Mac muss immer eingeschaltet und verbunden sein
  • - imsg und vollstaendiger Festplattenzugriff muessen auf dem Mac konfiguriert sein
Unterstuetzte Funktionen
OKLesebestaetigungen
OKiMessage-Reaktionen
OKGruppenchats
OKSMS-Unterstuetzung
OPTAnhaenge (optional)
OKNachrichtenverlauf
Fehlerbehebung

Berechtigung verweigert beim Lesen von chat.db?

Stelle sicher, dass du Terminal/iTerm und der OpenClaw-Ausfuehrungsdatei vollstaendigen Festplattenzugriff gewaehrt hast. Moeglicherweise musst du das Terminal nach der Gewaehrung neu starten.

Bot antwortet nicht auf Nachrichten?

Verifiziere, dass die Telefonnummer oder Apple ID in allowFrom genau uebereinstimmt. Telefonnummern benoetigen das + und die Laendervorwahl.

chat.db nicht gefunden?

Der Standardpfad ist ~/Library/Messages/chat.db. Stelle sicher, dass die Messages-App mindestens einmal geoeffnet wurde und du angemeldet bist.

imsg-Befehl nicht gefunden?

Stelle sicher, dass imsg installiert und in deinem PATH ist. Du kannst den vollstaendigen Pfad in cliPath angeben.

Remote-Gateway verbindet nicht?

Verifiziere, dass SSH-Schluessel-Authentifizierung mit ssh user@host funktioniert und dass der entfernte Mac imsg mit vollstaendigem Festplattenzugriff installiert hat.

iMessage verbunden!

Fuege weitere Kanaele hinzu oder konfiguriere Skills, um deinen KI-Assistenten anzupassen.

WhatsApp hinzufuegenSkills erkunden