Langsung ke konten
Panduan

OpenClaw di iMessage

Jembatan imsg, Mac tempat ia harus berjalan, izin, dan kompromi API privat

6 menit baca

OpenClaw berbicara iMessage melalui imsg, jembatan baris perintah yang dijalankan Gateway dan diajak berkomunikasi lewat JSON-RPC pada standard input dan output: tanpa daemon, tanpa port. Jembatan ini harus berjalan di Mac yang sudah login ke Messages, dan jika Gateway berada di tempat lain, Gateway menjangkau Mac itu melalui wrapper SSH. Dukungan BlueBubbles telah dihapus; imsg kini satu-satunya jalur. Berikut penyiapan, izin, dua mode, dan pola deployment yang direkomendasikan dokumentasi.

Penyiapan di Mac

  • Instal plugin iMessage resmi di host Gateway, lalu imsg melalui Homebrew dari tap-nya; wizard penyiapan dapat menawarkan instalasi itu, atau pembaruan, jika menemukan imsg yang belum ada atau yang dikelola Homebrew.
  • Arahkan saluran ke biner imsg dan ke database Messages di bawah folder Library milik pengguna, mulai Gateway, dan setujui penyandingan DM pertama: permintaan kedaluwarsa setelah satu jam.
  • Berikan Full Disk Access dan Automation ke konteks yang menjalankan imsg; prompt izin yang terlewat adalah salah satu entri pemecahan masalah yang tercantum, begitu juga pesan yang terkirim sementara tidak ada yang masuk.

Mode dasar dan mode API privat

Mode dasar adalah yang Anda dapatkan dari instalasi baru: teks dan media keluar, pemantauan dan riwayat pesan masuk, daftar chat, dan tanpa perubahan pada sistem. Mode API privat menyuntikkan helper ke Messages untuk menjangkau fungsi internalnya, yang membuka reaksi, edit, batal kirim, balasan berutas, efek, jajak pendapat native, pengelolaan grup, indikator mengetik, dan tanda sudah dibaca. Mode ini memerlukan System Integrity Protection dimatikan dan library validation dilonggarkan, dan injeksi menolak berjalan selama SIP aktif.

Menonaktifkan SIP adalah kompromi keamanan yang nyata.

Dokumentasi berterus terang soal kompromi itu: SIP adalah salah satu perlindungan inti macOS, mematikannya di Apple Silicon juga menghilangkan kemampuan menjalankan aplikasi iOS di Mac, dan rekomendasinya adalah Mac khusus atau pengguna bot khusus untuk jembatan itu. Jika model ancaman Anda tidak dapat menoleransi SIP mati di mana pun, saluran ini hanya dapat memakai mode dasar. Praktik terbaik keamanan OpenClaw adalah daftar periksa yang lebih luas.

Di mana Gateway berada

  • Mac yang sama: deployment yang umum, Gateway dan imsg bersama-sama di host Messages yang sudah login.
  • Mac jarak jauh melalui SSH atau Tailscale: Gateway di Linux atau VM, imsg di Mac dalam tailnet, wrapper SSH transparan sebagai path CLI, dan pengaturan remote host untuk lampiran. Wrapper harus meneruskan byte begitu tiba; wrapper yang melakukan buffering terlihat persis seperti iMessage sedang down.
  • Pengguna macOS khusus untuk bot: Apple ID dan pengguna terpisah sehingga lalu lintas bot tidak pernah menyentuh profil Messages pribadi Anda; saat pertama dijalankan, persetujuan Automation dan Full Disk Access diperlukan di sesi pengguna tersebut.

Pemulihan pesan masuk berjalan otomatis: setelah jembatan atau Gateway dimulai ulang, saluran memutar ulang pesan yang terlewat dan meredam tumpukan pesan yang dapat dikirim sekaligus oleh Apple setelah pemulihan push, tanpa mengirim apa pun dua kali. OpenClaw tidak merespons membahas tangga umum untuk saluran yang diam.

Artinya dalam praktik

iMessage adalah satu-satunya saluran yang tidak dapat dipindahkan dari perangkat keras Apple. Gateway di mana pun dapat melayaninya, tetapi hanya jika ada Mac di pihak Anda yang menjalankan imsg, sudah login, dalam keadaan aktif, dan dapat dijangkau, dan Mac itu menjadi bagian dari pekerjaan operasional: pembaruannya, izinnya, keputusan SIP-nya.

Di Diali

Di Diali, iMessage ada di roadmap, belum di daftar saluran yang dapat dihubungkan, karena Mac untuk Messages harus milik Anda dan penyandingan antara Mac itu dan Gateway yang di-hosting layak mendapat halamannya sendiri. Sampai saat itu, OpenClaw di Telegram adalah saluran yang paling banyak dipakai orang untuk memulai; OpenClaw yang di-hosting di Diali adalah asistennya.

  • imsg di Mac yang sudah login, Full Disk Access dan Automation, penyandingan untuk DM.
  • Mode dasar membiarkan SIP tetap aktif; API privat memerlukannya dimatikan, idealnya di Mac atau pengguna khusus.
  • Gateway dapat berada di mana saja; Mac tidak.
Mulai sekarang

Berhenti membaca, buat agen Anda sendiri

Siapkan agen, pilih saluran, dan biarkan ia bekerja di dalam aplikasi yang sudah selalu Anda buka.