​

إزالة BlueBubbles ومسار iMessage عبر imsg

لم يعد OpenClaw يتضمن قناة BlueBubbles. يعمل دعم iMessage من خلال Plugin imessage المضمّن: يشغّل Gateway أداة imsg كعملية فرعية، محليًا أو من خلال مغلّف SSH، ويتواصل معها عبر JSON-RPC باستخدام stdin/stdout. لا خادم، ولا Webhook، ولا منفذ. إذا كان إعدادك لا يزال يحتوي على channels.bluebubbles، فانقله إلى channels.imessage. يعيد عنوان URL القديم للوثائق /channels/bluebubbles التوجيه إلى الانتقال من BlueBubbles، الذي يتضمن جدول تحويل الإعدادات الكامل وقائمة التحقق الخاصة بالانتقال.

​

ما الذي تغيّر

• لا يتضمن مسار iMessage المدعوم خادم HTTP لـ BlueBubbles، أو مسار Webhook، أو كلمة مرور REST، أو بيئة تشغيل Plugin لـ BlueBubbles.
• يقرأ OpenClaw الرسائل ويراقبها من خلال imsg على جهاز Mac المسجّل دخوله إلى Messages.app.
• تستخدم عمليات الإرسال والاستلام والسجل والوسائط الأساسية واجهات imsg المعتادة وأذونات macOS.
• تتطلب الإجراءات المتقدمة (الردود المترابطة، وردود tapback، والتعديل، والتراجع عن الإرسال، والتأثيرات، وإيصالات القراءة، ومؤشرات الكتابة، وإدارة المجموعات) جسر واجهة API الخاصة: شغّل imsg launch، وهو ما يتطلب تعطيل SIP.
• لا يزال بإمكان بوابات Linux وWindows استخدام iMessage بتوجيه channels.imessage.cliPath إلى مغلّف SSH يشغّل imsg على جهاز Mac المسجّل دخوله.

​

ما يجب فعله

1. ثبّت imsg وتحقق منه على جهاز Mac الذي يشغّل Messages:
   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   imsg rpc --help
   
2. امنح أذونات الوصول الكامل إلى القرص والأتمتة لسياق العملية الذي يشغّل imsg وOpenClaw.
3. حوّل الإعداد القديم:
   {
     channels: {
       imessage: {
         enabled: true,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"],
         groupPolicy: "allowlist",
         groupAllowFrom: ["+15555550123"],
         groups: {
           "*": { requireMention: true },
         },
         includeAttachments: true,
       },
     },
   }
   
4. أعد تشغيل Gateway وتحقق:
   openclaw channels status --probe
   
5. اختبر الرسائل المباشرة والمجموعات والمرفقات وأي إجراءات خاصة بواجهة API تعتمد عليها قبل حذف خادم BlueBubbles القديم.

​

ملاحظات الترحيل

• ليس لـ channels.bluebubbles.serverUrl وchannels.bluebubbles.password مكافئان في iMessage؛ فلا يوجد خادم للاتصال به أو المصادقة لديه.
• تحتفظ allowFrom وgroupAllowFrom وgroups وincludeAttachments وattachmentRoots وmediaMaxMb وtextChunkLimit وactions.* بمعانيها ضمن channels.imessage.
• يظل channels.imessage.includeAttachments معطّلًا افتراضيًا. عيّنه صراحةً إذا كنت تتوقع وصول الصور الواردة أو المذكرات الصوتية أو مقاطع الفيديو أو الملفات إلى الوكيل.
• عند استخدام groupPolicy: "allowlist"، انسخ كتلة groups القديمة، بما في ذلك أي مُدخل بدل شامل "*". قوائم السماح لمرسلي المجموعات وسجل المجموعات بوابتان منفصلتان؛ تؤدي كتلة groups التي تحتوي على مُدخلات دون chat_id مطابق (أو دون "*") إلى إسقاط الرسالة في وقت التشغيل، بينما تسجّل كتلة groups الفارغة تحذيرًا عند بدء التشغيل رغم أن تصفية المرسلين لا تزال تسمح بمرور الرسائل.
• يجب تغيير روابط ACP التي تحتوي على match.channel: "bluebubbles" إلى "imessage".
• لا تتحول مفاتيح جلسات BlueBubbles القديمة إلى مفاتيح جلسات iMessage. تستند موافقات الاقتران إلى معرّفات المرسلين، لذلك تظل مُدخلات allowFrom المنسوخة فعّالة، لكن سجل المحادثات ضمن مفاتيح جلسات BlueBubbles لا ينتقل.

​

انظر أيضًا

• الانتقال من BlueBubbles
• iMessage
• مرجع الإعدادات - iMessage