Przejdź do głównej treści

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.

​
Usunięcie BlueBubbles i ścieżka imsg dla iMessage

OpenClaw nie dostarcza już kanału BlueBubbles. Obsługa iMessage działa teraz przez dołączony Plugin imessage, który uruchamia imsg lokalnie albo przez wrapper SSH i komunikuje się przez JSON-RPC po stdin/stdout. Jeśli Twoja konfiguracja nadal zawiera channels.bluebubbles, zmigruj ją do channels.imessage. Starszy URL dokumentacji /channels/bluebubbles przekierowuje do Migracja z BlueBubbles, gdzie znajduje się pełna tabela tłumaczenia konfiguracji i lista kontrolna przełączenia.

​
Co się zmieniło

  • W obsługiwanej ścieżce iMessage w OpenClaw nie ma serwera HTTP BlueBubbles, trasy Webhook, hasła REST ani środowiska uruchomieniowego Plugin BlueBubbles.
  • OpenClaw odczytuje i obserwuje Wiadomości przez imsg na Macu, na którym zalogowano się w Messages.app.
  • Podstawowe wysyłanie, odbieranie, historia i multimedia używają standardowych powierzchni imsg oraz uprawnień macOS.
  • Zaawansowane akcje, takie jak odpowiedzi w wątkach, tapbacki, edycja, cofnięcie wysłania, efekty, potwierdzenia odczytu, wskaźniki pisania i zarządzanie grupami, wymagają imsg launch z dostępnym mostkiem prywatnego API.
  • Gateway w systemach Linux i Windows nadal mogą używać iMessage przez ustawienie channels.imessage.cliPath na wrapper SSH, który uruchamia imsg na zalogowanym Macu.

​
Co zrobić

  1. Zainstaluj i zweryfikuj imsg na Macu z Wiadomościami: 
    brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help
  2. Przyznaj uprawnienia Pełnego dostępu do dysku oraz Automatyzacji kontekstowi procesu, który uruchamia imsg i OpenClaw.
  3. Przetłumacz starą konfigurację: 
    {
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/opt/homebrew/bin/imsg",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
      includeAttachments: true,
    },
  },
}
  4. Uruchom ponownie Gateway i zweryfikuj: 
    openclaw channels status --probe
  5. Przetestuj wiadomości DM, grupy, załączniki oraz wszelkie akcje prywatnego API, od których zależysz, zanim usuniesz stary serwer BlueBubbles.

​
Uwagi dotyczące migracji

  • channels.bluebubbles.serverUrl i channels.bluebubbles.password nie mają odpowiednika w iMessage.
  • channels.bluebubbles.allowFrom, groupAllowFrom, groups, includeAttachments, katalogi główne załączników, limity rozmiaru multimediów, dzielenie na części i przełączniki akcji mają odpowiedniki w iMessage.
  • channels.imessage.includeAttachments nadal jest domyślnie wyłączone. Ustaw je jawnie, jeśli oczekujesz, że przychodzące zdjęcia, notatki głosowe, filmy lub pliki trafią do agenta.
  • Przy groupPolicy: "allowlist" skopiuj stary blok groups, w tym dowolny wpis wieloznaczny "*". Listy dozwolonych nadawców grupowych i rejestr grup to oddzielne bramki.
  • Powiązania ACP dopasowane do channel: "bluebubbles" muszą zostać zmienione na channel: "imessage".
  • Stare klucze sesji BlueBubbles nie stają się kluczami sesji iMessage. Zatwierdzenia parowania są przenoszone według uchwytu, ale historia rozmów pod kluczami sesji BlueBubbles nie jest przenoszona.

​
Zobacz też