Verwijdering van BlueBubbles en het iMessage-pad via imsg

OpenClaw levert het BlueBubbles-kanaal niet meer mee. Ondersteuning voor iMessage verloopt via de meegeleverde imessage-plugin: de Gateway start imsg als een onderliggend proces, lokaal of via een SSH-wrapper, en communiceert via JSON-RPC over stdin/stdout. Geen server, geen Webhook, geen poort.

Als je configuratie nog channels.bluebubbles bevat, migreer je dit naar channels.imessage. De oude documentatie-URL /channels/bluebubbles verwijst door naar Overstappen van BlueBubbles, met de volledige tabel voor het omzetten van de configuratie en een checklist voor de overgang.

Wat is gewijzigd

• Het ondersteunde iMessage-pad heeft geen HTTP-server van BlueBubbles, Webhook-route, REST-wachtwoord of runtime van de BlueBubbles-plugin.
• OpenClaw leest en bewaakt Berichten via imsg op de Mac waarop bij Messages.app is ingelogd.
• Voor standaardfuncties voor verzenden, ontvangen, geschiedenis en media worden de normale imsg-interfaces en macOS-machtigingen gebruikt.
• Voor geavanceerde acties (antwoorden in threads, tapbacks, bewerken, verzenden ongedaan maken, effecten, leesbevestigingen, typindicatoren en groepsbeheer) is de privé-API-bridge nodig: voer imsg launch uit; hiervoor moet SIP zijn uitgeschakeld.
• Gateways op Linux en Windows kunnen iMessage nog steeds gebruiken door channels.imessage.cliPath te laten verwijzen naar een SSH-wrapper die imsg uitvoert op de Mac waarop is ingelogd.

Wat je moet doen

1. Installeer en controleer imsg op de Mac met Berichten:

   brew install steipete/tap/imsgimsg --versionimsg chats --limit 3imsg rpc --help

2. Verleen volledige schijftoegang en automatiseringsmachtigingen aan de procescontext waarin imsg en OpenClaw worden uitgevoerd.

3. Zet de oude configuratie om:

   {  channels: {    imessage: {      enabled: true,      cliPath: "/opt/homebrew/bin/imsg",      dmPolicy: "pairing",      allowFrom: ["+15555550123"],      groupPolicy: "allowlist",      groupAllowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },      includeAttachments: true,    },  },}

4. Start de Gateway opnieuw en controleer de status:

   openclaw channels status --probe

5. Test privéberichten, groepen, bijlagen en alle privé-API-acties waarvan je afhankelijk bent voordat je de oude BlueBubbles-server verwijdert.

Migratieopmerkingen

• channels.bluebubbles.serverUrl en channels.bluebubbles.password hebben geen equivalent voor iMessage; er is geen server om verbinding mee te maken of waarop verificatie nodig is.
• allowFrom, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit en actions.* behouden hun betekenis onder channels.imessage.
• channels.imessage.includeAttachments is standaard nog steeds uitgeschakeld. Stel dit expliciet in als je verwacht dat inkomende foto's, spraakmemo's, video's of bestanden de agent bereiken.
• Kopieer bij groupPolicy: "allowlist" het oude groups-blok, inclusief een eventuele jokertekenvermelding "*". Toegestane afzenders voor groepen en het groepsregister zijn afzonderlijke controles; een groups-blok met vermeldingen maar zonder overeenkomende chat_id (of zonder "*") verwijdert het bericht tijdens runtime, en een leeg groups-blok registreert bij het opstarten een waarschuwing, ook al laat de afzenderfiltering berichten nog steeds door.
• ACP-koppelingen met match.channel: "bluebubbles" moeten worden gewijzigd in "imessage".
• Oude BlueBubbles-sessiesleutels worden geen iMessage-sessiesleutels. Goedkeuringen voor koppeling zijn gebaseerd op afzenderidentificaties, waardoor gekopieerde allowFrom-vermeldingen blijven werken, maar de gespreksgeschiedenis onder BlueBubbles-sessiesleutels wordt niet overgezet.

Zie ook

• Overstappen van BlueBubbles
• iMessage
• Configuratiereferentie - iMessage