Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Entfernen von BlueBubbles und der imsg-iMessage-Pfad

OpenClaw liefert den BlueBubbles-Kanal nicht mehr aus. iMessage-Unterstützung läuft jetzt über das gebündelte imessage-Plugin, das imsg lokal oder über einen SSH-Wrapper startet und JSON-RPC über stdin/stdout spricht. Wenn Ihre Konfiguration noch channels.bluebubbles enthält, migrieren Sie sie zu channels.imessage. Die alte Dokumentations-URL /channels/bluebubbles leitet zu Von BlueBubbles kommend weiter. Dort finden Sie die vollständige Tabelle zur Konfigurationsübersetzung und die Cutover-Checkliste.

​
Was sich geändert hat

  • Im unterstützten OpenClaw-iMessage-Pfad gibt es keinen BlueBubbles-HTTP-Server, keine Webhook-Route, kein REST-Passwort und keine BlueBubbles-Plugin-Runtime.
  • OpenClaw liest und überwacht Nachrichten über imsg auf dem Mac, auf dem Messages.app angemeldet ist.
  • Grundlegendes Senden, Empfangen, Verlauf und Medien verwenden die normalen imsg-Oberflächen und macOS-Berechtigungen.
  • Erweiterte Aktionen wie Thread-Antworten, Tapbacks, Bearbeiten, Zurückziehen von Nachrichten, Effekte, Lesebestätigungen, Tippindikatoren und Gruppenverwaltung erfordern imsg launch mit verfügbarer Private-API-Bridge.
  • Linux- und Windows-Gateways können iMessage weiterhin verwenden, indem channels.imessage.cliPath auf einen SSH-Wrapper gesetzt wird, der imsg auf dem angemeldeten Mac ausführt.

​
Was zu tun ist

  1. Installieren und verifizieren Sie imsg auf dem Messages-Mac: 
    brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help
  2. Erteilen Sie dem Prozesskontext, der imsg und OpenClaw ausführt, Full-Disk-Access- und Automationsberechtigungen.
  3. Übersetzen Sie die alte Konfiguration: 
    {
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/opt/homebrew/bin/imsg",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
      includeAttachments: true,
    },
  },
}
  4. Starten Sie das Gateway neu und verifizieren Sie es: 
    openclaw channels status --probe
  5. Testen Sie DMs, Gruppen, Anhänge und alle Private-API-Aktionen, von denen Sie abhängig sind, bevor Sie Ihren alten BlueBubbles-Server löschen.

​
Migrationshinweise

  • channels.bluebubbles.serverUrl und channels.bluebubbles.password haben kein iMessage-Äquivalent.
  • channels.bluebubbles.allowFrom, groupAllowFrom, groups, includeAttachments, Attachment-Roots, Mediengrößenlimits, Chunking und Aktionsumschalter haben iMessage-Äquivalente.
  • channels.imessage.includeAttachments ist weiterhin standardmäßig deaktiviert. Setzen Sie es explizit, wenn Sie erwarten, dass eingehende Fotos, Sprachmemos, Videos oder Dateien den Agenten erreichen.
  • Mit groupPolicy: "allowlist" kopieren Sie den alten groups-Block, einschließlich eines etwaigen "*"-Wildcard-Eintrags. Absender-Allowlists für Gruppen und die Gruppenregistrierung sind getrennte Gates.
  • ACP-Bindungen, die channel: "bluebubbles" entsprachen, müssen zu channel: "imessage" geändert werden.
  • Alte BlueBubbles-Sitzungsschlüssel werden nicht zu iMessage-Sitzungsschlüsseln. Pairing-Freigaben werden nach Handle übernommen, aber der Konversationsverlauf unter BlueBubbles-Sitzungsschlüsseln nicht.

​
Siehe auch