iMessage

​

Hızlı kurulum

brew install steipete/tap/imsg
brew update && brew upgrade imsg
imsg rpc --help
imsg launch
openclaw channels status --probe

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/usr/local/bin/imsg",
      dbPath: "/Users/user/Library/Messages/chat.db",
    },
  },
}

openclaw gateway

openclaw pairing list imessage
openclaw pairing approve imessage <CODE>

ssh messages-mac 'brew install steipete/tap/imsg && brew update && brew upgrade imsg'

#!/usr/bin/env bash
exec ssh -T messages-mac imsg "$@"

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "user@gateway-host", // SCP ek getirmeleri için kullanılır
      includeAttachments: true,
      // İsteğe bağlı: izin verilen ek kökleri (varsayılan
      // /Users/*/Library/Messages/Attachments ile birleştirilir).
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
    },
  },
}

​

Gereksinimler ve izinler (macOS)

• Messages uygulamasında, imsg çalıştıran Mac’te oturum açılmış olmalıdır.
• OpenClaw/imsg çalıştıran işlem bağlamı için Tam Disk Erişimi gerekir (Messages veritabanı erişimi).
• Messages.app üzerinden ileti göndermek için Otomasyon izni gerekir.
• Gelişmiş eylemler (tepki / düzenleme / göndermeyi geri alma / ileti dizili yanıt / efektler / anketler / grup işlemleri) için Sistem Bütünlüğü Koruması devre dışı bırakılmalıdır — bkz. imsg özel API’sini etkinleştirme. Temel metin ve medya gönderme/alma işlemleri onsuz çalışır.

imsg chats --limit 1
# veya
imsg send <handle> "test"

Messages'a Apple olayları göndermek için yetkiniz yok. (-1743)

kTCCServiceAppleEvents | /usr/libexec/sshd-keygen-wrapper | auth_value=0 | com.apple.MobileSMS

​

imsg özel API’sini etkinleştirme

• Temel mod (varsayılan, SIP değişikliği gerekmez): send üzerinden giden metin ve medya, gelen ileti izleme/geçmişi ve sohbet listesi. Yeni bir brew install steipete/tap/imsg kurulumu ve yukarıdaki standart macOS izinleriyle kullanıma hazır olarak elde edilen budur.
• Özel API modu: imsg, dahili IMCore işlevlerini çağırmak için Messages.app içine yardımcı bir dylib enjekte eder. Bu; react, edit, unsend, reply (ileti dizili), sendWithEffect, poll ve poll-vote (yerel Messages anketleri), renameGroup, setGroupIcon, addParticipant, removeParticipant, leaveGroup özelliklerinin yanı sıra yazma göstergelerini ve okundu bilgilerini etkinleştirir.

read, typing, launch, köprü destekli zengin gönderim, ileti değiştirme ve sohbet yönetimi gibi gelişmiş özellikler isteğe bağlıdır. Bunlar, SIP’in devre dışı bırakılmasını ve Messages.app içine yardımcı bir dylib enjekte edilmesini gerektirir. SIP etkinse imsg launch enjeksiyon yapmayı reddeder.

​

Kurulum

1. Messages.app çalıştıran Mac’te imsg öğesini kurun (veya yükseltin):
   brew install steipete/tap/imsg
   brew update && brew upgrade imsg
   imsg --version
   imsg status --json
   
   imsg status --json çıktısı bridge_version, rpc_methods ve yöntem başına selectors bilgilerini bildirir; böylece başlamadan önce mevcut derlemenin neleri desteklediğini görebilirsiniz.
2. Sistem Bütünlüğü Koruması’nı ve (modern macOS’te) Kitaplık Doğrulaması’nı devre dışı bırakın. Apple imzalı Messages.app içine Apple’a ait olmayan bir yardımcı dylib enjekte etmek için SIP’in kapalı ve kitaplık doğrulamasının gevşetilmiş olması gerekir. Kurtarma modundaki SIP adımı macOS sürümüne özeldir:
   • macOS 10.13-10.15 (Sierra-Catalina): Terminal aracılığıyla Kitaplık Doğrulaması’nı devre dışı bırakın, Kurtarma Modu’nda yeniden başlatın, csrutil disable komutunu çalıştırın ve yeniden başlatın.
   • macOS 11+ (Big Sur ve sonrası), Intel: Kurtarma Modu’na (veya İnternet Kurtarma’ya) girin, csrutil disable komutunu çalıştırın ve yeniden başlatın.
   • macOS 11+, Apple Silicon: Kurtarma’ya girmek için güç düğmesiyle başlatma sırasını uygulayın; güncel macOS sürümlerinde Continue seçeneğine tıklarken Left Shift tuşunu basılı tutun, ardından csrutil disable komutunu çalıştırın. Sanal makine kurulumları ayrı bir akış izlediğinden önce bir VM anlık görüntüsü alın.
   macOS 11 ve sonrasında yalnızca csrutil disable genellikle yeterli değildir. Apple, bir platform ikili dosyası olan Messages.app için kitaplık doğrulamasını uygulamaya devam eder; bu nedenle geçici imzalanmış bir yardımcı, SIP kapalı olsa bile reddedilir (Library Validation failed: ... platform binary, but mapped file is not). SIP’i devre dışı bıraktıktan sonra kitaplık doğrulamasını da devre dışı bırakıp yeniden başlatın:
   sudo defaults write /Library/Preferences/com.apple.security.libraryvalidation.plist DisableLibraryValidation -bool true
   
   macOS 26 (Tahoe), 26.5.1 üzerinde doğrulandı: SIP’in kapalı olmasıyla birlikte yukarıdaki DisableLibraryValidation komutu, yardımcıyı 26.0 ile 26.5.x arasındaki sürümlerin tamamında enjekte etmek için yeterlidir. Hiçbir boot-arg gerekmez. Plist belirleyici etkendir ve Tahoe’da enjeksiyon başarısız olduğunda en sık eksik olan adımdır:
   • Plist varken: imsg launch enjeksiyonu gerçekleştirir ve imsg status, advanced_features: true bildirir.
   • Plist olmadan (SIP kapalı olsa bile): imsg launch, Failed to launch: Timeout waiting for Messages.app to initialize hatasıyla başarısız olur. AMFI, geçici imzalanmış yardımcıyı yükleme sırasında reddettiğinden köprü hiçbir zaman hazır duruma gelmez ve başlatma zaman aşımına uğrar. Bu zaman aşımı, Tahoe’da çoğu kişinin karşılaştığı belirtidir; çözüm daha köklü bir işlem değil, yukarıdaki plist’tir.
   Bir macOS yükseltmesinden sonra imsg launch enjeksiyonu veya belirli selectors değerleri false döndürmeye başlarsa olağan neden bu geçittir. SIP adımının başarısız olduğunu varsaymadan önce SIP ve kitaplık doğrulaması durumunuzu kontrol edin. Bu ayarlar doğru olduğu hâlde köprü hâlâ enjeksiyon yapamıyorsa imsg status --json ile imsg launch çıktısını toplayın ve sistem genelindeki ek güvenlik denetimlerini zayıflatmak yerine durumu imsg projesine bildirin.
3. Yardımcıyı enjekte edin. SIP devre dışıyken ve Messages.app oturumu açıkken:
   imsg launch
   
   imsg launch, SIP hâlâ etkinken enjeksiyonu reddeder; dolayısıyla bu işlem 2. adımın uygulandığını da doğrular.
4. Köprüyü OpenClaw üzerinden doğrulayın:
   openclaw channels status --probe
   
   iMessage girdisi works bildirmeli ve imsg status --json | jq '{rpc_methods, selectors}', macOS derlemenizin sunduğu yetenekleri göstermelidir. Anket oluşturmak için selectors.pollPayloadMessage; oy vermek için hem selectors.pollVoteMessage hem de poll.vote RPC yöntemi gerekir. OpenClaw plugin’i yalnızca önbelleğe alınmış yoklamanın desteklediği eylemleri duyururken boş bir önbellek iyimser kalır ve ilk gönderimde yoklama yapar.

​

SIP etkin kaldığında

• imsg temel moda geri döner — yalnızca metin + medya + alma.
• OpenClaw plugin’i metin/medya gönderimini ve gelen ileti izlemeyi duyurmaya devam eder; react, edit, unsend, reply, sendWithEffect ve grup işlemlerini eylem yüzeyinden gizler (yöntem başına yetenek geçidine göre).
• Birincil cihazlarınızda SIP’i etkin tutarken iMessage iş yükü için SIP’i kapalı ayrı bir Apple Silicon olmayan Mac (veya özel bir bot Mac’i) çalıştırabilirsiniz. Aşağıdaki Özel bot macOS kullanıcısı (ayrı iMessage kimliği) bölümüne bakın.

​

Erişim denetimi ve yönlendirme

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: { "*": { "requireMention": true } },
    },
  },
}

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { systemPrompt: "Britanya yazımını kullanın." },
        "8421": {
          requireMention: true,
          systemPrompt: "Bu, nöbet rotasyonu sohbetidir. Yanıtları 3 cümlenin altında tutun.",
        },
        "9907": {
          // açık bastırma: "Britanya yazımını kullanın." joker karakteri burada uygulanmaz
          systemPrompt: "",
        },
      },
    },
  },
}

​

ACP konuşma bağlamaları

• DM veya izin verilen grup sohbeti içinde /acp spawn codex --bind here komutunu çalıştırın.
• Aynı iMessage konuşmasındaki sonraki mesajlar, oluşturulan ACP oturumuna yönlendirilir.
• /new ve /reset, aynı bağlı ACP oturumunu yerinde sıfırlar.
• /acp close, ACP oturumunu kapatır ve bağlamayı kaldırır.

• +15555550123 veya user@example.com gibi normalleştirilmiş DM tanıtıcısı
• chat_id:<id> (kararlı grup bağlamaları için önerilir)
• chat_guid:<guid>
• chat_identifier:<identifier>

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: { agent: "codex", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "imessage",
        accountId: "default",
        peer: { kind: "group", id: "chat_id:123" },
      },
      acp: { label: "codex-group" },
    },
  ],
}

​

Dağıtım kalıpları

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "bot@mac-mini.tailnet-1234.ts.net",
      includeAttachments: true,
      dbPath: "/Users/bot/Library/Messages/chat.db",
    },
  },
}

#!/usr/bin/env bash
exec ssh -T bot@mac-mini.tailnet-1234.ts.net imsg "$@"

​

Medya, parçalara ayırma ve teslim hedefleri

imsg chats --limit 20

​

Özel API eylemleri

{
  channels: {
    imessage: {
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
        renameGroup: true,
        setGroupIcon: true,
        addParticipant: true,
        removeParticipant: true,
        leaveGroup: true,
        polls: true,
      },
    },
  },
}

{
  channels: {
    imessage: {
      sendReadReceipts: false,
    },
  },
}

​

Yapılandırma yazmaları

{
  channels: {
    imessage: {
      configWrites: false,
    },
  },
}

​

Bölünmüş gönderimli DM’leri birleştirme (tek bir oluşturmada komut + URL)

brew update && brew upgrade imsg

​

Köprü veya Gateway yeniden başlatıldıktan sonra gelen iletileri kurtarma

• Kalıcı yeniden oynatma koruması. OpenClaw, kurtarma imlecini ilerletmeden önce her ham satırı, olay kimliği olarak Apple GUID’siyle paylaşılan SQLite giriş kuyruğuna kaydeder. Tamamlanan bir satır yaklaşık 4 saat boyunca ve en fazla 10.000 girdi sınırıyla bir mezar taşı bırakır; böylece aynı GUID’ye sahip yeniden oynatma, yeniden başlatmadan sonra bile bırakılır. Bekleyen bir satır, dağıtım onu devralana kadar kurtarılabilir durumda kalır.
• Kesinti süresinden kurtarma. Başlangıçta izleyici, kalıcı olarak kabul edilen son chat.db rowid değerini (hesap başına kalıcı bir imleç) hatırlar ve bunu imsg watch.subscribe öğesine since_rowid olarak geçirir; böylece imsg, henüz günlüğe kaydedilmemiş satırları yeniden oynatır ve ardından canlı akışı izler. Çökmeden önce günlüğe kaydedilen satırlar SQLite’tan devam eder. Yeniden oynatma, en son 500 satırla ve en fazla ~2 saatlik iletilerle sınırlıdır; GUID mezar taşları ise daha önce işlenmiş her şeyi bırakır.
• Eski birikmiş iletiler için yaş sınırı. Başlangıç sınırının üzerindeki satırlar gerçekten canlıdır; gönderim tarihi varışından ~15 dakikadan daha eski olanlar Push boşaltma birikimidir ve bastırılır. Yeniden oynatılan satırlar (sınırda veya sınırın altında) bunun yerine daha geniş kurtarma penceresini kullanır; böylece yakın zamanda kaçırılan bir ileti teslim edilirken çok eski geçmiş teslim edilmez.

​

Operatör tarafından görülebilen sinyal

imessage: suppressed stale inbound backlog account=<id> sent=<iso> recovery=<bool> (<N> başlangıçtan bu yana bastırıldı)

​

Geçiş

​

Sorun giderme

imsg rpc --help
imsg status --json
openclaw channels status --probe

imsg chats --limit 10 --json
imsg watch --chat-id <chat-id> --json
sqlite3 ~/Library/Messages/chat.db \
  "select datetime(max(date)/1000000000 + 978307200, 'unixepoch', 'localtime'), max(ROWID) from message;"

launchctl kickstart -k system/com.apple.apsd
launchctl kickstart -k gui/$(id -u)/com.apple.CommCenter
launchctl kickstart -k gui/$(id -u)/com.apple.identityservicesd
launchctl kickstart -k gui/$(id -u)/com.apple.imagent
imsg launch
openclaw gateway restart

#!/usr/bin/env bash
exec ssh -T messages-mac imsg "$@"

openclaw channels status --probe --channel imessage

imsg chats --limit 1
imsg send <handle> "test"

​

Yapılandırma referansı bağlantıları

• Yapılandırma referansı - iMessage
• Gateway yapılandırması
• Eşleştirme

​

İlgili

• Kanallara Genel Bakış — desteklenen tüm kanallar
• BlueBubbles’ın kaldırılması ve imsg iMessage yolu — duyuru ve geçiş özeti
• BlueBubbles’tan geçiş — yapılandırma çeviri tablosu ve adım adım geçiş
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar — grup sohbeti davranışı ve bahsetme denetimi
• Kanal Yönlendirme — iletiler için oturum yönlendirmesi
• Güvenlik — erişim modeli ve sağlamlaştırma