OPUBLIKOWANO: 11 lutego 2026
Jeśli żyjesz w ekosystemie Apple, iMessage jest naturalnym miejscem do komunikacji: iPhone, iPad, Mac, synchronizacja, szybkie reakcje, grupy, załączniki. W idealnym świecie asystent AI też byłby po prostu kolejną rozmową w iMessage.
Problem jest prosty: Apple nie oferuje oficjalnego API do tworzenia botów iMessage. Nie ma „iMessage Business Bot” ani wygodnej integracji jak w Telegramie.
Rozwiązanie, które w praktyce działa bardzo dobrze, to BlueBubbles: serwer działający na macOS, który udostępnia REST API i webhooki dla iMessage. OpenClaw ma wbudowaną integrację BlueBubbles, więc możesz korzystać z asystenta AI przez iMessage – a jednocześnie zachować kontrolę nad danymi i uprawnieniami.
- Jak działa iMessage w OpenClaw (BlueBubbles w skrócie)
- Wymagania i ograniczenia (uczciwie)
- Setup krok po kroku: BlueBubbles + OpenClaw
- Bezpieczeństwo: pairing/allowlist i sensowne granice
- Najczęstsze problemy (i szybkie fixy)
Jak działa iMessage w OpenClaw (BlueBubbles w skrócie)
OpenClaw nie rozmawia bezpośrednio z iMessage. Zamiast tego łączy się z BlueBubbles Server uruchomionym na Macu:
- Wiadomości wychodzące (od asystenta) idą przez REST API BlueBubbles.
- Wiadomości przychodzące (od Ciebie w iMessage) trafiają do OpenClaw przez webhook.
To podejście ma dwie duże zalety.
Po pierwsze, integracja jest bogata: poza samym tekstem BlueBubbles wspiera m.in. reakcje (tapbacks), read receipts, typing indicators, a w wielu konfiguracjach także edycję/unsend i reply threading.
Po drugie, architektura jest pod Twoją kontrolą: BlueBubbles działa na Twoim Macu, a OpenClaw może działać na tym samym Macu albo na innym serwerze (np. Linux/VPS) – ważne, żeby webhooki mogły do niego dotrzeć.
Wymagania i ograniczenia (uczciwie)
Żeby iMessage działało, potrzebujesz Maca z uruchomionym BlueBubbles Server i zalogowanym iMessage w aplikacji Messages. Ten Mac w praktyce powinien być zawsze włączony. Jeśli go wyłączysz, integracja przestanie działać.
Warto też znać dwie życiowe rzeczy:
- W konfiguracjach headless/VM Messages.app czasem zasypia. Da się to obejść prostym skryptem „poke”, który co kilka minut dotyka Messages przez AppleScript.
- To nie jest oficjalne API Apple. Zwykle działa stabilnie, ale aktualizacje macOS mogą czasem wymagać korekt.
| Element | Wymaganie | Uwagi |
| Mac | macOS + Messages.app | BlueBubbles działa na macOS |
| BlueBubbles Server | Włączone Web API + hasło | To jest most do iMessage |
| OpenClaw Gateway | Dostępny dla webhooków | Może być na Macu albo na innym serwerze |
Setup krok po kroku: BlueBubbles + OpenClaw
1) Postaw BlueBubbles Server na Macu
Zainstaluj BlueBubbles zgodnie z instrukcją: bluebubbles.app/install.
W ustawieniach BlueBubbles:
- włącz Web API,
- ustaw hasło (traktuj jak sekret),
- zanotuj
serverUrl, np.http://192.168.1.100:1234.
2) Skonfiguruj OpenClaw (wizard lub CLI)
Najprościej:
openclaw onboardi wybierz kanał BlueBubbles.
Jeśli wolisz CLI, możesz dodać kanał tak:
openclaw channels add --channel bluebubbles \
--http-url http://192.168.1.100:1234 \
--password "<twoje-haslo>" \
--webhook-path /bluebubbles-webhook3) Skieruj webhook BlueBubbles do Gateway
W BlueBubbles ustaw webhook na URL Gateway. Typowy przykład (z hasłem w query):
https://twoj-host:3000/bluebubbles-webhook?password=<password>
Upewnij się, że webhookPath w OpenClaw i ścieżka w BlueBubbles są zgodne.
4) Uruchom i sprawdź
openclaw gateway status
openclaw channels status --deepJeśli wszystko działa, możesz napisać do asystenta przez iMessage, a odpowiedź wróci tą samą drogą.
BlueBubbles wymaga zawsze włączonego Maca z zalogowanym iMessage. Każde wylogowanie lub restart wymaga ponownego sparowania. Dla stabilności rozważ dedykowanego Mac mini lub stary MacBook jako serwer.
Bezpieczeństwo: pairing/allowlist i sensowne granice
Największy błąd to otwarty bot. W OpenClaw domyślna polityka DM dla BlueBubbles to pairing, czyli nieznany nadawca dostaje kod parowania i nic więcej nie zrobi bez Twojej akceptacji.
W praktyce warto trzymać się dwóch zasad:
- na start pairing, potem allowlist,
- w grupach:
requireMention=true, żeby asystent nie odpowiadał na wszystko.
Jeśli planujesz używać iMessage jako kanału do spraw firmowych, tym bardziej pilnuj granic: asystent może przygotować draft e-maila czy raport, ale akcje o wysokiej stawce (wysyłka, płatność, zmiany w systemach) powinny wymagać potwierdzenia.
Najczęstsze problemy (i szybkie fixy)
Brak wiadomości przychodzących: prawie zawsze problem z webhookiem (zły URL, zła ścieżka, brak dostępu sieciowego do Gateway).
Messages.app zasypia: dodaj prosty AppleScript + LaunchAgent, który puka do Messages co 5 minut (standardowy workaround w headless setupach).
Za długie odpowiedzi: ustaw sensowną długość odpowiedzi albo dzielenie, bo kanały wiadomości mają limity.
Jeśli utknąłeś, sprawdź logi kanału:
openclaw channels logs