الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
إزالة BlueBubbles ومسار imsg في iMessage

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

​
ما الذي تغيّر

  • لا يوجد خادم HTTP لـ BlueBubbles، أو مسار Webhook، أو كلمة مرور REST، أو وقت تشغيل Plugin لـ BlueBubbles في مسار iMessage المدعوم في OpenClaw.
  • يقرأ OpenClaw الرسائل ويراقبها من خلال imsg على جهاز Mac الذي تم تسجيل الدخول فيه إلى Messages.app.
  • تستخدم عمليات الإرسال والاستقبال والسجل والوسائط الأساسية واجهات imsg العادية وأذونات macOS.
  • تتطلب الإجراءات المتقدمة مثل الردود المتسلسلة، وtapbacks، والتحرير، وإلغاء الإرسال، والتأثيرات، وإيصالات القراءة، ومؤشرات الكتابة، وإدارة المجموعات استخدام imsg launch مع توفر جسر API الخاص.
  • يمكن لـ Gateways على 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. امنح أذونات Full Disk Access وAutomation لسياق العملية الذي يشغّل 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 القديم.

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

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

​
انظر أيضًا