iMessage (eski: imsg)

Yeni iMessage dağıtımları için BlueBubbles kullanın.imsg entegrasyonu eskidir ve gelecekteki bir sürümde kaldırılabilir.

Durum: eski harici CLI entegrasyonu. Gateway, imsg rpc başlatır ve stdio üzerinde JSON-RPC ile iletişim kurar (ayrı daemon/port yoktur).

BlueBubbles (önerilen)

Yeni kurulumlar için tercih edilen iMessage yolu.

Eşleştirme

iMessage DM’leri varsayılan olarak eşleştirme modunu kullanır.

Yapılandırma başvurusu

iMessage için tüm alan başvurusu.

Hızlı kurulum

Yerel Mac (hızlı yol)
SSH üzerinden uzak Mac

imsg yükleyin ve doğrulayın

brew install steipete/tap/imsg
imsg rpc --help

OpenClaw yapılandırın

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

Gateway başlatın

openclaw gateway

İlk DM eşleştirmesini onaylayın (varsayılan dmPolicy)

openclaw pairing list imessage
openclaw pairing approve imessage <CODE>

Eşleştirme isteklerinin süresi 1 saat sonra dolar.

OpenClaw yalnızca stdio uyumlu bir cliPath gerektirir; bu nedenle cliPath değerini uzak bir Mac’e SSH ile bağlanıp imsg çalıştıran bir sarmalayıcı betiğe yönlendirebilirsiniz.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

Ekler etkinleştirildiğinde önerilen yapılandırma:

{
  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öklerini geçersiz kılın.
      // Varsayılanlar /Users/*/Library/Messages/Attachments içerir
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
    },
  },
}

remoteHost ayarlı değilse, OpenClaw SSH sarmalayıcı betiğini ayrıştırarak bunu otomatik algılamaya çalışır. remoteHost, host veya user@host olmalıdır (boşluk veya SSH seçenekleri olmadan). OpenClaw, SCP için katı ana makine anahtarı denetimi kullanır; bu nedenle aktarma ana makinesi anahtarı ~/.ssh/known_hosts içinde zaten bulunmalıdır. Ek yolları izin verilen köklere göre doğrulanır (attachmentRoots / remoteAttachmentRoots).

Gereksinimler ve izinler (macOS)

Messages, imsg çalıştıran Mac’te oturum açmış olmalıdır.
OpenClaw/imsg çalıştıran işlem bağlamı için Tam Disk Erişimi gereklidir (Messages DB erişimi).
Messages.app üzerinden mesaj göndermek için Otomasyon izni gereklidir.

İzinler işlem bağlamı başına verilir. Gateway başsız çalışıyorsa (LaunchAgent/SSH), istemleri tetiklemek için aynı bağlamda bir defalık etkileşimli komut çalıştırın:

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

Erişim denetimi ve yönlendirme

DM ilkesi
Grup ilkesi + anmalar
Oturumlar ve deterministik yanıtlar

channels.imessage.dmPolicy, doğrudan mesajları denetler:

pairing (varsayılan)
allowlist
open (allowFrom içinde "*" bulunmasını gerektirir)
disabled

Allowlist alanı: channels.imessage.allowFrom.Allowlist girdileri handle’lar veya sohbet hedefleri olabilir (chat_id:*, chat_guid:*, chat_identifier:*).

channels.imessage.groupPolicy, grup işlemesini denetler:

allowlist (yapılandırıldığında varsayılan)
open
disabled

Grup gönderen allowlist’i: channels.imessage.groupAllowFrom.Çalışma zamanı fallback’i: groupAllowFrom ayarlı değilse, iMessage grup gönderen denetimleri kullanılabilir olduğunda allowFrom değerine geri düşer. Çalışma zamanı notu: channels.imessage tamamen eksikse, çalışma zamanı groupPolicy="allowlist" değerine geri düşer ve bir uyarı kaydeder (channels.defaults.groupPolicy ayarlı olsa bile).Gruplar için anma geçitlemesi:

iMessage, yerel anma meta verisine sahip değildir
anma algılama regex desenleri kullanır (agents.list[].groupChat.mentionPatterns, fallback messages.groupChat.mentionPatterns)
yapılandırılmış desen yoksa anma geçitlemesi zorunlu kılınamaz

Yetkili gönderenlerden gelen denetim komutları, gruplarda anma geçitlemesini aşabilir.

DM’ler doğrudan yönlendirme kullanır; gruplar grup yönlendirmesi kullanır.
Varsayılan session.dmScope=main ile iMessage DM’leri agent ana oturumunda toplanır.
Grup oturumları yalıtılmıştır (agent:<agentId>:imessage:group:<chat_id>).
Yanıtlar, kaynak kanal/hedef meta verileri kullanılarak yeniden iMessage’a yönlendirilir.

Grup benzeri konu davranışı:Bazı çok katılımcılı iMessage konuları is_group=false ile gelebilir. Bu chat_id, channels.imessage.groups altında açıkça yapılandırılmışsa OpenClaw bunu grup trafiği olarak ele alır (grup geçitlemesi + grup oturumu yalıtımı).

ACP konuşma bağlamaları

Eski iMessage sohbetleri ACP oturumlarına da bağlanabilir. Hızlı operatör akışı:

DM veya izin verilen grup sohbeti içinde /acp spawn codex --bind here ç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.

Yapılandırılmış kalıcı bağlamalar, üst düzey bindings[] girdileri üzerinden type: "acp" ve match.channel: "imessage" ile desteklenir. match.peer.id şu biçimleri kullanabilir:

+15555550123 veya user@example.com gibi normalize edilmiş DM handle’ı
chat_id:<id> (kararlı grup bağlamaları için önerilir)
chat_guid:<guid>
chat_identifier:<identifier>

Örnek:

{
  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" },
    },
  ],
}

Paylaşılan ACP bağlama davranışı için ACP Agent’ları sayfasına bakın.

Dağıtım kalıpları

Ayrılmış bot macOS kullanıcısı (ayrı iMessage kimliği)

Bot trafiğinin kişisel Messages profilinizden yalıtılması için ayrılmış bir Apple ID ve macOS kullanıcısı kullanın.Tipik akış:

Ayrılmış bir macOS kullanıcısı oluşturun/oturum açın.
Bu kullanıcıda bot Apple ID’siyle Messages oturumu açın.
Bu kullanıcıda imsg yükleyin.
OpenClaw’ın bu kullanıcı bağlamında imsg çalıştırabilmesi için SSH sarmalayıcısı oluşturun.
channels.imessage.accounts.<id>.cliPath ve .dbPath değerlerini bu kullanıcı profiline yönlendirin.

İlk çalıştırma, bu bot kullanıcı oturumunda GUI onayları gerektirebilir (Otomasyon + Tam Disk Erişimi).

Tailscale üzerinden uzak Mac (örnek)

Yaygın topoloji:

gateway Linux/VM üzerinde çalışır
iMessage + imsg, tailnet’inizdeki bir Mac üzerinde çalışır
cliPath sarmalayıcısı imsg çalıştırmak için SSH kullanır
remoteHost, SCP ek getirmelerini etkinleştirir

Örnek:

{
  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 "$@"

Hem SSH hem SCP’nin etkileşimsiz olması için SSH anahtarları kullanın. known_hosts doldurulsun diye önce ana makine anahtarının güvenilir olduğundan emin olun (örneğin ssh bot@mac-mini.tailnet-1234.ts.net).

Çok hesaplı kalıp

iMessage, channels.imessage.accounts altında hesap başına yapılandırmayı destekler.Her hesap cliPath, dbPath, allowFrom, groupPolicy, mediaMaxMb, geçmiş ayarları ve ek kökü allowlist’leri gibi alanları geçersiz kılabilir.

Medya, parçalama ve teslimat hedefleri

Ekler ve medya

gelen ek alımı isteğe bağlıdır: channels.imessage.includeAttachments
remoteHost ayarlandığında uzak ek yolları SCP ile alınabilir
ek yolları izin verilen köklerle eşleşmelidir:
- channels.imessage.attachmentRoots (yerel)
- channels.imessage.remoteAttachmentRoots (uzak SCP modu)
- varsayılan kök deseni: /Users/*/Library/Messages/Attachments
SCP, katı ana makine anahtarı denetimi kullanır (StrictHostKeyChecking=yes)
giden medya boyutu channels.imessage.mediaMaxMb kullanır (varsayılan 16 MB)

Giden parçalama

metin parça sınırı: channels.imessage.textChunkLimit (varsayılan 4000)
parça modu: channels.imessage.chunkMode
- length (varsayılan)
- newline (önce paragraf bölme)

Adresleme biçimleri

Tercih edilen açık hedefler:

chat_id:123 (kararlı yönlendirme için önerilir)
chat_guid:...
chat_identifier:...

Handle hedefleri de desteklenir:

imessage:+1555...
sms:+1555...
user@example.com

imsg chats --limit 20

Yapılandırma yazımları

iMessage, varsayılan olarak kanal tarafından başlatılan yapılandırma yazımlarına izin verir (commands.config: true olduğunda /config set|unset için). Devre dışı bırakmak için:

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

Sorun giderme

imsg bulunamadı veya RPC desteklenmiyor

İkili dosyayı ve RPC desteğini doğrulayın:

imsg rpc --help
openclaw channels status --probe

Probe, RPC desteklenmiyor bildiriyorsa imsg güncelleyin.

DM'ler yok sayılıyor

Şunları kontrol edin:

channels.imessage.dmPolicy
channels.imessage.allowFrom
eşleştirme onayları (openclaw pairing list imessage)

Grup mesajları yok sayılıyor

Şunları kontrol edin:

channels.imessage.groupPolicy
channels.imessage.groupAllowFrom
channels.imessage.groups allowlist davranışı
anma deseni yapılandırması (agents.list[].groupChat.mentionPatterns)

Uzak ekler başarısız oluyor

Şunları kontrol edin:

channels.imessage.remoteHost
channels.imessage.remoteAttachmentRoots
gateway ana makinesinden SSH/SCP anahtar kimlik doğrulaması
gateway ana makinesindeki ~/.ssh/known_hosts içinde ana makine anahtarının mevcut olması
Messages çalıştıran Mac’te uzak yol okunabilirliği

macOS izin istemleri kaçırıldı

Aynı kullanıcı/oturum bağlamında etkileşimli GUI terminalinde yeniden çalıştırın ve istemleri onaylayın:

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

OpenClaw/imsg çalıştıran işlem bağlamı için Tam Disk Erişimi + Otomasyon izinlerinin verildiğini doğrulayın.

Yapılandırma başvurusu işaretçileri

İlgili

Kanallara Genel Bakış — desteklenen tüm kanallar
Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
Gruplar — grup sohbeti davranışı ve anma geçitlemesi
Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
Güvenlik — erişim modeli ve sağlamlaştırma

Overview

Messaging platforms

Configuration

iMessage

iMessage (eski: imsg)

BlueBubbles (önerilen)

Eşleştirme

Yapılandırma başvurusu

Hızlı kurulum

Gereksinimler ve izinler (macOS)

Erişim denetimi ve yönlendirme

ACP konuşma bağlamaları

Dağıtım kalıpları

Medya, parçalama ve teslimat hedefleri

Yapılandırma yazımları

Sorun giderme

Yapılandırma başvurusu işaretçileri

İlgili

Overview

Messaging platforms

Configuration

​iMessage (eski: imsg)

BlueBubbles (önerilen)

Eşleştirme

Yapılandırma başvurusu

​Hızlı kurulum

​Gereksinimler ve izinler (macOS)

​Erişim denetimi ve yönlendirme

​ACP konuşma bağlamaları

​Dağıtım kalıpları

​Medya, parçalama ve teslimat hedefleri

​Yapılandırma yazımları

​Sorun giderme

​Yapılandırma başvurusu işaretçileri

​İlgili

iMessage (eski: imsg)

Hızlı kurulum

Gereksinimler ve izinler (macOS)

Erişim denetimi ve yönlendirme

ACP konuşma bağlamaları

Dağıtım kalıpları

Medya, parçalama ve teslimat hedefleri

Yapılandırma yazımları

Sorun giderme

Yapılandırma başvurusu işaretçileri

İlgili