BlueBubbles'dan Geçiş

​

Geçiş kontrol listesi

1. Messages.app çalıştıran Mac üzerinde imsg aracını doğrudan doğrulayın (imsg chats, imsg history, imsg send ve imsg rpc --help).
2. Davranış anahtarlarını channels.bluebubbles içinden channels.imessage içine kopyalayın: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit, coalesceSameSenderDms ve actions.
3. Artık mevcut olmayan aktarım anahtarlarını kaldırın: serverUrl, password, Webhook URL’leri ve BlueBubbles sunucu kurulumu.
4. Gateway, Messages Mac üzerinde çalışmıyorsa channels.imessage.cliPath değerini bir SSH sarmalayıcısına ayarlayın ve uzaktan ek getirmeleri için remoteHost değerini belirleyin.
5. Gateway durdurulmuşken channels.imessage kanalını etkinleştirin, ardından openclaw channels status --probe --channel imessage komutunu çalıştırın.
6. Bir DM’yi, izin verilen bir grubu, etkinse ekleri ve aracının kullanmasını beklediğiniz her özel API eylemini test edin.
7. iMessage yolu doğrulandıktan sonra BlueBubbles sunucusunu ve eski channels.bluebubbles yapılandırmasını silin.

​

Bu geçiş ne zaman anlamlıdır?

• Messages.app oturumu açık olan aynı Mac üzerinde (veya SSH üzerinden erişilebilen bir Mac üzerinde) zaten imsg çalıştırıyorsunuz.
• Daha az hareketli parça istiyorsunuz: ayrı BlueBubbles sunucusu yok, kimlik doğrulaması gerektiren REST uç noktası yok, Webhook tesisatı yok. Sunucu + istemci uygulaması + yardımcı yerine tek bir CLI ikilisi.
• Özel API yoklamasının available: true bildirdiği desteklenen macOS / imsg derlemesi kullanıyorsunuz.

​

imsg ne yapar?

• Okumalar, salt okunur bir SQLite tanıtıcısı kullanılarak ~/Library/Messages/chat.db içinden gelir.
• Canlı gelen iletiler, yoklama geri dönüşüyle chat.db dosya sistemi olaylarını izleyen imsg watch / watch.subscribe üzerinden gelir.
• Gönderimler, normal metin ve dosya gönderimleri için Messages.app otomasyonunu kullanır.
• Gelişmiş eylemler, imsg yardımcısını Messages.app içine enjekte etmek için imsg launch kullanır. Okundu bilgileri, yazıyor göstergeleri, zengin gönderimler, düzenleme, geri alma, konu içi yanıt, tapback’ler ve grup yönetimini açan şey budur.
• Linux derlemeleri kopyalanmış bir chat.db dosyasını inceleyebilir, ancak gönderim yapamaz, canlı Mac veritabanını izleyemez veya Messages.app aracını süremez. OpenClaw iMessage için imsg aracını oturum açılmış Mac üzerinde ya da o Mac’e giden bir SSH sarmalayıcısı üzerinden çalıştırın.

​

Başlamadan önce

1. Messages.app çalıştıran Mac üzerine imsg yükleyin:
   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   
   imsg chats komutu unable to open database file, boş çıktı veya authorization denied hatasıyla başarısız olursa imsg aracını başlatan terminale, düzenleyiciye, Node sürecine, Gateway hizmetine veya SSH üst sürecine Tam Disk Erişimi verin, ardından bu üst süreci yeniden açın.
2. OpenClaw yapılandırmasını değiştirmeden önce okuma, izleme, gönderme ve RPC yüzeylerini doğrulayın:
   imsg chats --limit 10 --json | jq -s
   imsg history --chat-id 42 --limit 10 --attachments --json | jq -s
   imsg watch --chat-id 42 --reactions --json
   imsg send --chat-id 42 --text "OpenClaw imsg test"
   imsg rpc --help
   
   42 değerini imsg chats çıktısından gerçek bir sohbet kimliğiyle değiştirin. Gönderim, Messages.app için Automation izni gerektirir. OpenClaw SSH üzerinden çalışacaksa bu komutları OpenClaw’ın kullanacağı aynı SSH sarmalayıcısı veya kullanıcı bağlamı üzerinden çalıştırın. Okumalar/yoklamalar çalışıyor ancak gönderimler AppleEvents -1743 ile başarısız oluyorsa Automation izninin /usr/libexec/sshd-keygen-wrapper üzerine düşüp düşmediğini kontrol edin; bkz. SSH sarmalayıcı gönderimleri AppleEvents -1743 ile başarısız oluyor.
3. Gelişmiş eylemlere ihtiyacınız olduğunda özel API köprüsünü etkinleştirin:
   imsg launch
   imsg status --json
   
   imsg launch, SIP’in devre dışı bırakılmış olmasını gerektirir. Temel gönderim, geçmiş ve izleme imsg launch olmadan çalışır; gelişmiş eylemler çalışmaz.
4. Etkin bir channels.imessage yapılandırması ekledikten sonra köprüyü OpenClaw üzerinden doğrulayın:
   openclaw channels status --probe
   
   İstenen değer imessage.privateApi.available: true değeridir. false bildirirse önce bunu düzeltin; bkz. Yetenek algılama. channels status --probe yalnızca yapılandırılmış ve etkin hesapları yoklar.
5. Yapılandırmanızın anlık kopyasını alın:
   cp ~/.openclaw/openclaw.json5 ~/.openclaw/openclaw.json5.bak
   

​

Yapılandırma çevirisi

​

Grup kayıt defteri tuzağı

1. Gönderen / sohbet hedefi izin listesi (channels.imessage.groupAllowFrom) — isAllowedIMessageSender tarafından denetlenir. Gelen iletileri gönderen handle, chat_guid, chat_identifier veya chat_id ile eşleştirir. BlueBubbles ile aynı şekle sahiptir.
2. Grup kayıt defteri (channels.imessage.groups) — inbound-processing.ts:199 içindeki resolveChannelGroupPolicy tarafından denetlenir. groupPolicy: "allowlist" ile bu kapı şunlardan birini gerektirir:
   • bir groups: { "*": { ... } } joker girdisi (allowAll = true ayarlar), veya
   • groups altında açık bir chat_id başına girdi.

• groupPolicy: "allowlist" ayarlanmışken channels.imessage.groups boşsa ("*" jokeri yok, chat_id başına girdi yok) hesap başına bir defalık başlangıç warn iletisi; herhangi bir ileti ulaşmadan önce tetiklenir.
• Belirli bir grup çalışma zamanında ilk kez düşürüldüğünde chat_id başına bir defalık warn iletisi; chat_id’yi ve buna izin vermek için groups içine eklenecek tam anahtarı belirtir.

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123", "chat_guid:any;-;..."],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
}

​

Adım adım

1. Mevcut BlueBubbles bloğunun yanına bir iMessage bloğu ekleyin. Gateway hâlâ BlueBubbles trafiğini yönlendirirken bunu devre dışı bırakılmış tutun:
   {
     channels: {
       bluebubbles: {
         enabled: true,
         // ... existing config ...
       },
       imessage: {
         enabled: false,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"], // copy from bluebubbles.allowFrom
         groupPolicy: "allowlist",
         groupAllowFrom: [], // copy from bluebubbles.groupAllowFrom
         groups: { "*": { requireMention: true } }, // copy from bluebubbles.groups — silently drops groups if missing, see "Group registry footgun" above
         actions: {
           reactions: true,
           edit: true,
           unsend: true,
           reply: true,
           sendWithEffect: true,
           sendAttachment: true,
         },
       },
     },
   }
   
2. Trafik önemli hale gelmeden önce yoklayın — Gateway’i durdurun, iMessage bloğunu geçici olarak etkinleştirin ve iMessage’ın CLI üzerinden sağlıklı raporlandığını doğrulayın:
   openclaw gateway stop
   # edit config: channels.imessage.enabled = true
   openclaw channels status --probe --channel imessage   # expect imessage.privateApi.available: true
   
   channels status --probe yalnızca yapılandırılmış ve etkin hesapları yoklar. Her iki kanal izleyicisinin de çalışmasını bilinçli olarak istemiyorsanız Gateway’i BlueBubbles ve iMessage aynı anda etkin durumdayken yeniden başlatmayın. Hemen geçiş yapmıyorsanız Gateway’i yeniden başlatmadan önce channels.imessage.enabled değerini tekrar false olarak ayarlayın. OpenClaw trafiğini etkinleştirmeden önce Mac’i doğrulamak için Başlamadan önce bölümündeki doğrudan imsg komutlarını kullanın.
3. Geçiş yapın. Etkin iMessage hesabı sağlıklı raporlandıktan sonra BlueBubbles yapılandırmasını kaldırın ve iMessage’ı etkin tutun:
   {
     channels: {
       imessage: { enabled: true /* ... */ },
     },
   }
   
   Gateway’i yeniden başlatın. Gelen iMessage trafiği artık paketlenmiş Plugin üzerinden akar.
4. DM’leri doğrulayın. Aracıya doğrudan mesaj gönderin; yanıtın ulaştığını doğrulayın.
5. Grupları ayrı doğrulayın. DM’ler ve gruplar farklı kod yolları kullanır — DM başarısı grupların yönlendirildiğini kanıtlamaz. Aracıya eşleştirilmiş bir grup sohbetinde mesaj gönderin ve yanıtın ulaştığını doğrulayın. Grup sessiz kalırsa (aracı yanıtı yok, hata yok), Gateway günlüğünde imessage: dropping group message from chat_id=<id> ya da başlangıçta imessage: groupPolicy="allowlist" but channels.imessage.groups is empty satırı olup olmadığını kontrol edin — ikisi de varsayılan günlük düzeyinde tetiklenir. İkisinden biri görünüyorsa groups bloğunuz eksik ya da boştur — yukarıdaki “Grup kayıt tuzağı” bölümüne bakın.
6. Eylem yüzeyini doğrulayın — eşleştirilmiş bir DM’den aracıdan tepki vermesini, düzenlemesini, göndermeyi geri almasını, yanıtlamasını, fotoğraf göndermesini ve (bir grupta) grubu yeniden adlandırmasını / katılımcı eklemesini ya da kaldırmasını isteyin. Her eylem Messages.app içinde yerel olarak gerçekleşmelidir. Herhangi biri “iMessage <action> requires the imsg private API bridge” hatası verirse imsg launch komutunu yeniden çalıştırın ve channels status --probe durumunu yenileyin.
7. iMessage DM’leri, grupları ve eylemleri doğrulandıktan sonra BlueBubbles sunucusunu ve yapılandırmasını kaldırın. OpenClaw channels.bluebubbles kullanmaz.

​

Bir bakışta eylem eşliği

​

Eşleştirme, oturumlar ve ACP bağları

• Eşleştirme onayları tanıtıcıya göre taşınır. Bilinen gönderenleri yeniden onaylamanız gerekmez — channels.imessage.allowFrom, BlueBubbles’ın kullandığı aynı +15555550123 / user@example.com dizelerini tanır.
• Oturumlar aracı + sohbet başına kapsamlandırılmış kalır. DM’ler varsayılan session.dmScope=main altında aracı ana oturumuna daralır; grup oturumları chat_id başına izole kalır. Oturum anahtarları farklıdır (agent:<id>:imessage:group:<chat_id> ve BlueBubbles eşdeğeri) — BlueBubbles oturum anahtarları altındaki eski konuşma geçmişi iMessage oturumlarına taşınmaz.
• match.channel: "bluebubbles" referansı veren ACP bağları "imessage" olarak güncellenmelidir. match.peer.id biçimleri (chat_id:, chat_guid:, chat_identifier:, çıplak tanıtıcı) aynıdır.

​

Geri dönüş kanalı yok

​

İlgili

• BlueBubbles kaldırma ve imsg iMessage yolu — kısa duyuru ve operatör özeti.
• iMessage — imsg launch kurulumu ve yetenek algılama dahil tam iMessage kanal başvurusu.
• /channels/bluebubbles — bu geçiş kılavuzuna yönlendiren eski URL.
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı.
• Kanal Yönlendirme — Gateway’in giden yanıtlar için kanalı nasıl seçtiği.