BlueBubbles'dan geçiş yapma

​

Geçiş kontrol listesi

1. Messages.app’i çalıştıran Mac’te doğrudan imsg değerini doğrulayın (imsg chats, imsg history, imsg send, imsg rpc --help).
2. Davranış anahtarlarını channels.bluebubbles konumundan channels.imessage konumuna kopyalayın: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit 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’te çalışmıyorsa channels.imessage.cliPath değerini bir SSH sarmalayıcısına ayarlayın ve uzaktan ek getirme işlemleri için remoteHost değerini ayarlayın.
5. channels.imessage özelliğini etkinleştirin, Gateway’i yeniden başlatın, ardından openclaw channels status --probe --channel imessage komutunu çalıştırın.
6. Bir doğrudan mesajı, izin verilen bir grubu, etkinleştirilmişse 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.

​

imsg ne yapar?

• Okuma işlemleri, salt okunur bir SQLite tanıtıcısı kullanılarak ~/Library/Messages/chat.db kaynağından gerçekleştirilir.
• Canlı gelen mesajlar, chat.db dosya sistemi olaylarını yoklama yedeğiyle takip eden imsg watch / watch.subscribe kaynağından gelir.
• Normal metin ve dosya gönderimleri, Messages.app otomasyonu kullanılarak gerçekleştirilir.
• Gelişmiş eylemler, imsg yardımcısını Messages.app’e enjekte etmek için imsg launch kullanır. Okundu bilgileri, yazıyor göstergeleri, zengin gönderimler, düzenleme, gönderimi geri alma, ileti dizili yanıt, tapback’ler, anketler ve grup yönetimi bu şekilde kullanılabilir hâle gelir.
• Linux derlemeleri, kopyalanmış bir chat.db dosyasını inceleyebilir ancak gönderim yapamaz, canlı Mac veritabanını izleyemez veya Messages.app’i çalıştıramaz. OpenClaw iMessage için imsg aracını oturum açılmış Mac’te veya bu Mac’e bağlanan bir SSH sarmalayıcısı üzerinden çalıştırın.

​

Başlamadan önce

1. Messages.app’i çalıştıran Mac’e imsg yükleyin:
   brew install steipete/tap/imsg
   brew update && brew upgrade imsg
   imsg --version
   imsg chats --limit 3
   
   Olağan yerel kurulumda OpenClaw kurulumu, oturum açılmış Messages Mac’teki imsg için kullanıcı onaylı bir Homebrew yüklemesi veya güncellemesi sunabilir. Manuel kurulumlar ve SSH sarmalayıcısı topolojileri operatör tarafından yönetilmeye devam eder: Homebrew güncellemesini, imsg aracını çalıştıracak aynı yerel veya uzak kullanıcı bağlamında yineleyin. imsg chats; 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 ve 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 kaynağındaki gerçek bir sohbet kimliğiyle değiştirin. Gönderim için Messages.app’e Otomasyon izni verilmesi gerekir. 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. Okuma işlemleri çalışıyor ancak gönderimler AppleEvents -1743 hatasıyla başarısız oluyorsa Otomasyon izninin /usr/libexec/sshd-keygen-wrapper üzerine atanıp atanmadığını kontrol edin; SSH sarmalayıcısı gönderimleri AppleEvents -1743 hatasıyla başarısız oluyor bölümüne bakın.
3. Özel API köprüsünü etkinleştirin. Yanıtlar, tapback’ler, efektler, anketler, ek yanıtları ve grup eylemleri buna bağlı olduğundan OpenClaw iMessage için kesinlikle önerilir:
   imsg launch
   imsg status --json
   
   imsg launch, SIP’nin devre dışı bırakılmasını gerektirir (modern macOS’te ayrıca kitaplık doğrulamasının gevşetilmesi gerekir; bkz. imsg özel API’sini etkinleştirme). Temel gönderim, geçmiş ve izleme işlevleri imsg launch olmadan çalışır; OpenClaw iMessage’ın tam eylem yüzeyi çalışmaz.
4. channels.imessage özelliğini etkinleştirip Gateway’i başlattıktan sonra köprüyü OpenClaw üzerinden doğrulayın:
   openclaw channels status --probe
   
   iMessage hesabı works bildirmelidir; --json ile yoklama yükü privateApi.available: true içerir. false bildirirse önce bunu düzeltin; Yetenek algılama bölümüne bakın. Yoklama için erişilebilir bir Gateway gerekir (aksi hâlde CLI yalnızca yapılandırma çıktısına geri döner) ve yalnızca yapılandırılmış, etkin hesaplar yoklanır.
5. Yapılandırmanızın anlık görüntüsünü alın:
   cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
   

​

Yapılandırma dönüşümü

​

Grup kayıt defteri tuzağı

1. Gönderen / sohbet hedefi izin listesi (channels.imessage.groupAllowFrom) — gönderen tanıtıcısıyla veya sohbet hedefiyle (chat_id:, chat_guid:, chat_identifier: girdileri) eşleşir. groupAllowFrom ayarlanmadığında bu geçit allowFrom değerine geri döner; açıkça belirtilen groupAllowFrom: [] bu geri dönüşü devre dışı bırakır ve groupPolicy: "allowlist" kapsamında her grup mesajını atar.
2. Grup kayıt defteri (channels.imessage.groups) — sayısal iMessage chat_id ile anahtarlanır:
   • groups bloğu yoksa (veya boşsa): 1. geçidin boş olmayan etkin bir gönderen izin listesi olduğu sürece gruplar bu geçitten geçer; erişimi gönderen filtrelemesi yönetir ve başlangıçta tümünü atma uyarısı verilmez.
   • Girdileri olan ancak "*" içermeyen groups: yalnızca listelenen chat_id anahtarları geçer. Herhangi bir grubu listelemek, groupPolicy: "open" altında bile kayıt defterini bir izin listesine dönüştürür.
   • groups: { "*": { ... } }: her grup bu geçitten geçer.

• groupPolicy: "allowlist" ayarlandığında ve etkin grup gönderen izin listesi boş olduğunda, başlangıçta hesap başına bir kez: imessage: groupPolicy="allowlist" for account "<id>" but no group sender allowlist is configured .... Gönderenleri kabul etmek için groupAllowFrom (veya allowFrom) ayarlayın; yalnızca groups eklemek gönderen geçidini karşılamaz.
• Kayıt defteri bir grubu attığında çalışma zamanında chat_id başına bir kez: imessage: dropping group message from chat_id=<id> ... not in channels.imessage.groups allowlist; eklenecek tam anahtarı belirtir.

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

​

Adım adım

1. Yapılandırmayı çevirin. Düzenlerken yeni bloğu devre dışı bırakın; eski channels.bluebubbles bloğu güncel OpenClaw tarafından yok sayılır ve başvuru amacıyla yanında kalabilir:
   {
     channels: {
       imessage: {
         enabled: false, // geçişe hazır olduğunuzda true yapın
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"], // bluebubbles.allowFrom değerinden kopyalayın
         groupPolicy: "allowlist",
         groupAllowFrom: [], // bluebubbles.groupAllowFrom değerinden kopyalayın
         groups: { "*": { requireMention: true } }, // joker karakteri olduğu gibi kopyalayın; sohbet başına girdileri chat_id ile yeniden anahtarlayın
         // eylemler varsayılan olarak etkindir; devre dışı bırakmak için ayrı ayrı açma/kapama ayarlarını false yapın
       },
     },
   }
   
2. Geçişi yapın ve yoklayın. channels.imessage.enabled: true değerini ayarlayın, Gateway’i yeniden başlatın ve kanalın sağlıklı olarak bildirildiğini doğrulayın:
   openclaw gateway restart
   openclaw channels status --probe --channel imessage   # "works" beklenir; --json, privateApi.available: true değerini gösterir
   
   Yoklama, erişilebilir bir Gateway gerektirir ve yalnızca yapılandırılmış, etkin hesapları yoklar. Mac’in kendisini doğrulamak için Başlamadan önce bölümündeki doğrudan imsg komutlarını kullanın.
3. DM’leri doğrulayın. Ajana doğrudan mesaj gönderin; yanıtın ulaştığını doğrulayın.
4. Grupları ayrı olarak doğrulayın. DM’ler ve gruplar farklı kod yollarını kullanır — DM başarısı, grupların yönlendirildiğini kanıtlamaz. İzin verilen bir grup sohbetinde mesaj gönderin ve yanıtın ulaştığını doğrulayın. Grup sessiz kalırsa (ajan yanıtı ve hata yoksa), yukarıdaki “Grup kayıt defteri tuzağı” bölümünde belirtilen iki warn satırı için gateway günlüğünü kontrol edin. Başlangıç uyarısı, geçerli gönderen izin listesinin boş olduğu anlamına gelir; chat_id başına verilen uyarı ise doldurulmuş bir groups kayıt defterinin ilgili sohbeti içermediği anlamına gelir.
5. Eylem yüzeyini doğrulayın. Eşleştirilmiş bir DM’den ajandan tepki vermesini, düzenlemesini, göndermeyi geri almasını, yanıtlamasını, fotoğraf göndermesini ve (bir grupta) grubun adını değiştirmesini ya da katılımcı ekleyip kaldırmasını isteyin. Her eylem Messages.app içinde yerel olarak gerçekleşmelidir. Herhangi bir eylem iMessage <action> requires the imsg private API bridge hatası verirse imsg launch komutunu yeniden çalıştırın ve openclaw channels status --probe ile yenileyin.
6. iMessage DM’leri, grupları ve eylemleri doğrulandıktan sonra BlueBubbles sunucusunu ve channels.bluebubbles bloğunu kaldırın. OpenClaw, channels.bluebubbles değerini okumaz.

​

Bir bakışta eylem eşdeğerliği

​

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

• İzin listeleri tanıtıcıya göre aktarılır. channels.imessage.allowFrom, BlueBubbles’ın kullandığı aynı +15555550123 / user@example.com dizelerini tanır — bunları aynen kopyalayın.
• Eşleştirme deposu onayları aktarılmaz. Eşleştirme deposu kanal başınadır ve eski BlueBubbles deposunu hiçbir şey taşımaz. Yalnızca eşleştirme yoluyla onaylanan gönderenler iMessage altında bir kez daha eşleşmelidir veya tanıtıcılarını allowFrom listesine eklemeniz gerekir.
• Oturumlar, ajan + sohbet başına kapsamlandırılmış olarak kalır. DM’ler varsayılan session.dmScope=main altında ajanın ana oturumunda birleştirilir; grup oturumları her chat_id (agent:<agentId>:imessage:group:<chat_id>) için ayrı tutulur. BlueBubbles oturum anahtarları altındaki eski konuşma geçmişi iMessage oturumlarına aktarılmaz.
• match.channel: "bluebubbles" değerine başvuran ACP bağlamaları, "imessage" olarak değiştirilmelidir. match.peer.id biçimleri (chat_id:, chat_guid:, chat_identifier:, yalın tanıtıcı) aynıdır.

​

Geri dönüş kanalı yoktur

​

İlgili içerikler

• BlueBubbles’ın kaldırılması ve imsg iMessage yolu — kısa duyuru ve operatör özeti.
• iMessage — imsg launch kurulumu ve yetenek algılama dâhil eksiksiz 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.