Zum Inhalt springen
Ratgeber

OpenClaw auf iMessage

Die imsg-Bridge, der Mac, auf dem sie laufen muss, Berechtigungen und der Kompromiss der privaten API

6 Min. Lesezeit

OpenClaw spricht iMessage über imsg, eine Kommandozeilen-Bridge, die das Gateway startet und mit der es per JSON-RPC über Standardeingabe und -ausgabe kommuniziert: kein Daemon, kein Port. Sie muss auf einem Mac laufen, der in der Nachrichten-App angemeldet ist, und wenn das Gateway woanders läuft, erreicht es diesen Mac über einen SSH-Wrapper. Die Unterstützung für BlueBubbles wurde entfernt; imsg ist jetzt der einzige Weg. Hier sind die Einrichtung, die Berechtigungen, die beiden Modi und die Deployment-Muster, die die Dokumentation empfiehlt.

Einrichtung auf dem Mac

  • Installieren Sie das offizielle iMessage-Plugin auf dem Gateway-Host und dann imsg über Homebrew aus dessen Tap; der Einrichtungsassistent kann diese Installation oder ein Update anbieten, wenn er ein fehlendes oder von Homebrew verwaltetes imsg findet.
  • Richten Sie den Kanal auf das imsg-Binary und auf die Datenbank der Nachrichten-App im Library-Ordner des Nutzers, starten Sie das Gateway und geben Sie die erste DM-Kopplung frei: Anfragen verfallen nach einer Stunde.
  • Erteilen Sie dem Kontext, der imsg ausführt, Festplattenvollzugriff und Automation; verpasste Berechtigungsabfragen sind ein aufgeführter Eintrag zur Fehlerbehebung, ebenso Nachrichten, die gesendet werden, während nichts ankommt.

Basismodus und Private-API-Modus

Der Basismodus ist das, was eine frische Installation liefert: ausgehender Text und Medien, eingehende Überwachung und Verlauf, die Chatliste und keine Änderungen am System. Der Private-API-Modus injiziert einen Helper in die Nachrichten-App, um ihre internen Funktionen zu erreichen, was Reaktionen, Bearbeitungen, Senden widerrufen, Antworten in Threads, Effekte, native Umfragen, Gruppenverwaltung, Tippindikatoren und Lesebestätigungen freischaltet. Er erfordert einen ausgeschalteten Systemintegritätsschutz und eine gelockerte Library-Validierung, und die Injektion verweigert den Start, solange SIP aktiv ist.

SIP zu deaktivieren ist ein echter Sicherheitskompromiss.

Die Dokumentation ist bei diesem Kompromiss direkt: SIP ist einer der zentralen Schutzmechanismen von macOS, das Abschalten auf Apple Silicon nimmt außerdem die Möglichkeit, iOS-Apps auf dem Mac auszuführen, und die Empfehlung ist ein eigener Mac oder ein eigener Bot-Nutzer für die Bridge. Wenn Ihr Bedrohungsmodell ausgeschaltetes SIP nirgends toleriert, bleibt der Kanal auf den Basismodus beschränkt. Sicherheits-Best-Practices für OpenClaw ist die umfassendere Checkliste.

Wo das Gateway läuft

  • Derselbe Mac: das übliche Deployment, Gateway und imsg zusammen auf dem Host, der in der Nachrichten-App angemeldet ist.
  • Entfernter Mac über SSH oder Tailscale: das Gateway auf Linux oder einer VM, imsg auf einem Mac im Tailnet, ein transparenter SSH-Wrapper als CLI-Pfad und eine Remote-Host-Einstellung für Anhänge. Der Wrapper muss Bytes weiterleiten, sobald sie ankommen; einer, der puffert, sieht genau wie ein iMessage-Ausfall aus.
  • Eigener macOS-Nutzer für den Bot: eine separate Apple-ID und ein separater Nutzer, damit Bot-Verkehr nie Ihr persönliches Profil in der Nachrichten-App berührt; beim ersten Start sind die Freigaben für Automation und Festplattenvollzugriff in der Sitzung dieses Nutzers nötig.

Die eingehende Wiederherstellung erfolgt automatisch: Nach einem Neustart der Bridge oder des Gateways spielt der Kanal nach, was verpasst wurde, und unterdrückt den Rückstau, den Apple nach einer Push-Wiederherstellung ausspülen kann, ohne etwas doppelt zuzustellen. OpenClaw antwortet nicht behandelt die allgemeine Leiter für stumme Kanäle.

Was das in der Praxis bedeutet

iMessage ist der eine Kanal, der sich nicht von Apple-Hardware lösen lässt. Ein Gateway irgendwo kann ihn bedienen, aber nur mit einem Mac auf Ihrer Seite, auf dem imsg läuft, der angemeldet, wach und erreichbar ist, und dieser Mac wird Teil der Betriebsarbeit: seine Updates, seine Berechtigungen, seine SIP-Entscheidung.

Bei Diali

Bei Diali steht iMessage auf der Roadmap statt in der Liste der verbindbaren Kanäle, weil der Mac mit der Nachrichten-App Ihnen gehören muss und die Kopplung zwischen ihm und einem gehosteten Gateway eine eigene Seite verdient. Bis dahin ist OpenClaw auf Telegram der Kanal, mit dem die meisten beginnen; Gehostetes OpenClaw bei Diali ist der Assistent.

  • imsg auf einem angemeldeten Mac, Festplattenvollzugriff und Automation, Kopplung für Direktnachrichten.
  • Der Basismodus lässt SIP an; die private API braucht es ausgeschaltet, idealerweise auf einem eigenen Mac oder mit eigenem Nutzer.
  • Das Gateway kann überall laufen; der Mac nicht.
Jetzt starten

Genug gelesen, bauen Sie selbst einen

Richten Sie einen Agenten ein, wählen Sie einen Kanal und lassen Sie ihn in der App arbeiten, die Sie ohnehin geöffnet haben.