إزالة 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/imsgimsg --versionimsg chats --limit 3imsg 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