iMessage

​

الإعداد السريع

brew install steipete/tap/imsg
brew update && brew upgrade imsg
imsg rpc --help
imsg launch
openclaw channels status --probe

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

openclaw gateway

openclaw pairing list imessage
openclaw pairing approve imessage <CODE>

ssh messages-mac 'brew install steipete/tap/imsg && brew update && brew upgrade imsg'

#!/usr/bin/env bash
exec ssh -T messages-mac imsg "$@"

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "user@gateway-host", // يُستخدم لجلب المرفقات عبر SCP
      includeAttachments: true,
      // اختياري: جذور إضافية مسموح بها للمرفقات (تُدمج مع الجذر الافتراضي
      // /Users/*/Library/Messages/Attachments).
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
    },
  },
}

​

المتطلبات والأذونات (macOS)

• يجب تسجيل الدخول إلى Messages على جهاز Mac الذي يشغّل imsg.
• يلزم منح الوصول الكامل إلى القرص لسياق العملية الذي يشغّل OpenClaw‏/imsg (للوصول إلى قاعدة بيانات Messages).
• يلزم إذن الأتمتة لإرسال الرسائل عبر Messages.app.
• بالنسبة إلى الإجراءات المتقدمة (التفاعل / التعديل / إلغاء الإرسال / الرد المتسلسل / التأثيرات / الاستطلاعات / عمليات المجموعات)، يجب تعطيل حماية تكامل النظام — راجع تمكين API الخاص لـ imsg. يعمل الإرسال والاستقبال الأساسيان للنصوص والوسائط من دون تعطيلها.

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

غير مصرّح بإرسال أحداث Apple إلى Messages. (-1743)

kTCCServiceAppleEvents | /usr/libexec/sshd-keygen-wrapper | auth_value=0 | com.apple.MobileSMS

​

تمكين API الخاص لـ imsg

• الوضع الأساسي (الافتراضي، لا يلزم إجراء تغييرات على SIP): إرسال النصوص والوسائط عبر send، ومراقبة الرسائل الواردة وسجلها، وقائمة المحادثات. هذا ما تحصل عليه مباشرة من تثبيت brew install steipete/tap/imsg جديد مع أذونات macOS القياسية المذكورة أعلاه.
• وضع API الخاص: يحقن imsg مكتبة dylib مساعدة في Messages.app لاستدعاء وظائف IMCore الداخلية. يتيح ذلك react وedit وunsend وreply (المتسلسل) وsendWithEffect وpoll وpoll-vote (استطلاعات Messages الأصلية) وrenameGroup وsetGroupIcon وaddParticipant وremoveParticipant وleaveGroup، بالإضافة إلى مؤشرات الكتابة وإيصالات القراءة.

الميزات المتقدمة مثل read وtyping وlaunch، والإرسال الغني المدعوم بالجسر، وتعديل الرسائل، وإدارة المحادثات اختيارية. وتتطلب تعطيل SIP وحقن مكتبة dylib مساعدة في Messages.app. يرفض imsg launch إجراء الحقن عندما تكون SIP مفعّلة.

​

الإعداد

1. ثبّت (أو رقِّ) imsg على جهاز Mac الذي يشغّل Messages.app:
   brew install steipete/tap/imsg
   brew update && brew upgrade imsg
   imsg --version
   imsg status --json
   
   تعرض مخرجات imsg status --json القيم bridge_version وrpc_methods وselectors لكل طريقة، حتى تتمكن من معرفة ما يدعمه الإصدار الحالي قبل البدء.
2. عطّل حماية تكامل النظام، و(في إصدارات macOS الحديثة) التحقق من صحة المكتبات. يتطلب حقن مكتبة dylib مساعدة غير تابعة لـ Apple في Messages.app الموقّع من Apple تعطيل SIP وكذلك تخفيف قيود التحقق من صحة المكتبات. تعتمد خطوة SIP في وضع الاسترداد على إصدار macOS:
   • macOS 10.13-10.15 (Sierra-Catalina): عطّل التحقق من صحة المكتبات عبر Terminal، وأعد التشغيل في وضع الاسترداد، وشغّل csrutil disable، ثم أعد التشغيل.
   • macOS 11+ (Big Sur والإصدارات الأحدث)، Intel: ادخل وضع الاسترداد (أو الاسترداد عبر الإنترنت)، وشغّل csrutil disable، ثم أعد التشغيل.
   • macOS 11+، Apple Silicon: استخدم تسلسل بدء التشغيل بزر الطاقة للدخول إلى وضع الاسترداد؛ وفي إصدارات macOS الحديثة، اضغط باستمرار على مفتاح Left Shift عند النقر على Continue، ثم شغّل csrutil disable. تتبع إعدادات الأجهزة الافتراضية مسارًا منفصلًا، لذا التقط لقطة للجهاز الافتراضي أولًا.
   في macOS 11 والإصدارات الأحدث، لا يكفي csrutil disable وحده عادةً. تواصل Apple فرض التحقق من صحة المكتبات على Messages.app بصفته ملفًا ثنائيًا للنظام الأساسي، ولذلك تُرفض الأداة المساعدة الموقّعة بتوقيع مخصص (Library Validation failed: ... platform binary, but mapped file is not) حتى مع تعطيل SIP. بعد تعطيل SIP، عطّل أيضًا التحقق من صحة المكتبات وأعد التشغيل:
   sudo defaults write /Library/Preferences/com.apple.security.libraryvalidation.plist DisableLibraryValidation -bool true
   
   macOS 26 (Tahoe)، تم التحقق منه على 26.5.1: يكفي تعطيل SIP بالإضافة إلى أمر DisableLibraryValidation أعلاه لحقن الأداة المساعدة في الإصدارات من 26.0 إلى 26.5.x. لا يلزم استخدام أي boot-args. ملف plist هو العامل الحاسم والخطوة المفقودة الأكثر شيوعًا عند فشل الحقن على Tahoe:
   • مع ملف plist: يحقن imsg launch وتُبلغ imsg status عن advanced_features: true.
   • من دون ملف plist (حتى مع تعطيل SIP): يفشل imsg launch مع Failed to launch: Timeout waiting for Messages.app to initialize. يرفض AMFI الأداة المساعدة الموقّعة بتوقيع مخصص عند التحميل، فلا يصبح الجسر جاهزًا أبدًا وتنتهي مهلة التشغيل. انتهاء المهلة هذا هو العَرَض الذي يواجهه معظم الأشخاص على Tahoe؛ والحل هو ملف plist أعلاه، وليس إجراءً أكثر تشددًا.
   إذا بدأ حقن imsg launch أو إجراءات selectors معينة بإرجاع false بعد ترقية macOS، فعادةً ما تكون هذه البوابة هي السبب. تحقّق من حالة SIP والتحقق من صحة المكتبات قبل افتراض فشل خطوة SIP نفسها. إذا كانت هذه الإعدادات صحيحة وما زال الجسر غير قادر على الحقن، فاجمع imsg status --json مع مخرجات imsg launch وأبلغ عنها إلى مشروع imsg بدلًا من إضعاف ضوابط أمان إضافية على مستوى النظام بأكمله.
3. احقن الأداة المساعدة. مع تعطيل SIP وتسجيل الدخول إلى Messages.app:
   imsg launch
   
   يرفض imsg launch إجراء الحقن عندما يظل SIP مفعّلًا، لذا يُعد ذلك أيضًا تأكيدًا على تنفيذ الخطوة 2.
4. تحقّق من الجسر من OpenClaw:
   openclaw channels status --probe
   
   ينبغي أن يُبلغ إدخال iMessage عن works، وينبغي أن يعرض imsg status --json | jq '{rpc_methods, selectors}' الإمكانات التي يوفّرها إصدار macOS لديك. يتطلب إنشاء استطلاعات الرأي selectors.pollPayloadMessage؛ ويتطلب التصويت كلًا من selectors.pollVoteMessage وطريقة RPC المسماة poll.vote. لا يعلن Plugin الخاص بـ OpenClaw إلا عن الإجراءات التي يدعمها الفحص المخزّن مؤقتًا، بينما تظل ذاكرة التخزين المؤقت الفارغة متفائلة وتجري الفحص عند أول إرسال.

​

عند إبقاء SIP مفعّلًا

• يرجع imsg إلى الوضع الأساسي — النصوص والوسائط والاستقبال فقط.
• يواصل Plugin الخاص بـ OpenClaw الإعلان عن إرسال النصوص/الوسائط ومراقبة الرسائل الواردة؛ ويخفي react وedit وunsend وreply وsendWithEffect وعمليات المجموعات من سطح الإجراءات (وفق بوابة الإمكانات الخاصة بكل طريقة).
• يمكن تشغيل جهاز Mac منفصل لا يعتمد Apple Silicon (أو جهاز Mac مخصص للبوت) مع تعطيل SIP لأحمال عمل iMessage، مع إبقاء SIP مفعّلًا على أجهزتك الأساسية. راجع مستخدم macOS مخصص للبوت (هوية iMessage منفصلة) أدناه.

​

التحكم في الوصول والتوجيه

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: { "*": { "requireMention": true } },
    },
  },
}

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { systemPrompt: "استخدم التهجئة البريطانية." },
        "8421": {
          requireMention: true,
          systemPrompt: "هذه محادثة مناوبة الدعم. اجعل الردود أقل من 3 جمل.",
        },
        "9907": {
          // تعطيل صريح: لا ينطبق حرف البدل "استخدم التهجئة البريطانية." هنا
          systemPrompt: "",
        },
      },
    },
  },
}

​

ارتباطات محادثات ACP

• شغّل /acp spawn codex --bind here داخل الرسالة المباشرة أو محادثة المجموعة المسموح بها.
• تُوجّه الرسائل المستقبلية في محادثة iMessage نفسها إلى جلسة ACP المنشأة.
• تعيد /new و/reset ضبط جلسة ACP المرتبطة نفسها في موضعها.
• تغلق /acp close جلسة ACP وتزيل الارتباط.

• معرّف رسالة مباشرة مطبّعًا مثل +15555550123 أو user@example.com
• chat_id:<id> (موصى به لارتباطات المجموعات المستقرة)
• chat_guid:<guid>
• chat_identifier:<identifier>

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

​

أنماط النشر

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

​

الوسائط والتقسيم ووجهات التسليم

imsg chats --limit 20

​

إجراءات واجهة API الخاصة

{
  channels: {
    imessage: {
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
        renameGroup: true,
        setGroupIcon: true,
        addParticipant: true,
        removeParticipant: true,
        leaveGroup: true,
        polls: true,
      },
    },
  },
}

{
  channels: {
    imessage: {
      sendReadReceipts: false,
    },
  },
}

​

عمليات كتابة الإعدادات

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

​

دمج الرسائل الخاصة المجزّأة عند الإرسال (أمر + عنوان URL في إنشاء واحد)

1. رسالة نصية ("Dump").
2. فقاعة معاينة لعنوان URL‏ ("https://...") تتضمن صور معاينة OG كمرفقات.

{
  channels: {
    imessage: {
      coalesceSameSenderDms: true, // تفعيل اختياري (الافتراضي: false)
    },
  },
}

{
  messages: {
    inbound: {
      byChannel: {
        // تغطي 7000 ms تأخيرات معاينة عنوان URL الملحوظة في Messages.app.
        imessage: 7000,
      },
    },
  },
}

​

السيناريوهات وما يراه الوكيل

​

استرداد الرسائل الواردة بعد إعادة تشغيل الجسر أو Gateway

• إزالة تكرار إعادة التشغيل. تُسجَّل كل رسالة واردة تم إرسالها بواسطة GUID الخاص بها لدى Apple في حالة Plugin الدائمة (imessage.inbound-dedupe)، وتُحجز عند الإدخال وتُثبَّت بعد المعالجة (ويُحرَّر الحجز عند حدوث فشل عابر لتتمكن من إعادة المحاولة). يُسقط أي شيء سبق التعامل معه بدلًا من إرساله مرتين. وهذا ما يتيح لإعادة الاسترداد أن تعمل بقوة من دون مسك سجلات لكل رسالة.
• الاسترداد بعد التوقف. عند بدء التشغيل، تتذكر أداة المراقبة آخر rowid لصف chat.db تم إرساله (مؤشر دائم لكل حساب) وتمرره إلى imsg watch.subscribe بوصفه since_rowid، فيعيد imsg تشغيل الصفوف التي وصلت أثناء توقف Gateway، ثم يتابع الرسائل الحية. تقتصر إعادة التشغيل على أحدث 500 صف وعلى الرسائل التي لا يزيد عمرها على ~2 hours، وتُسقط إزالة التكرار أي شيء سبق التعامل معه.
• حاجز عمر التراكم القديم. الصفوف التي تتجاوز حد بدء التشغيل حية فعلًا؛ ويُمنع أي صف يزيد تاريخ إرساله على وقت وصوله بأكثر من ~15 minutes لأنه يمثل التراكم الناتج عن تفريغ Push. أما الصفوف المعاد تشغيلها (عند الحد أو دونه) فتستخدم نافذة الاسترداد الأوسع بدلًا من ذلك، بحيث تُسلَّم الرسالة الفائتة حديثًا بينما لا يُسلَّم السجل القديم.

​

إشارة مرئية للمشغّل

imessage: تم منع تراكم وارد قديم account=<id> sent=<iso> recovery=<bool> (تم منع <N> منذ البدء)

​

الترحيل

​

استكشاف الأخطاء وإصلاحها

imsg rpc --help
imsg status --json
openclaw channels status --probe

imsg chats --limit 10 --json
imsg watch --chat-id <chat-id> --json
sqlite3 ~/Library/Messages/chat.db \
  "select datetime(max(date)/1000000000 + 978307200, 'unixepoch', 'localtime'), max(ROWID) from message;"

launchctl kickstart -k system/com.apple.apsd
launchctl kickstart -k gui/$(id -u)/com.apple.CommCenter
launchctl kickstart -k gui/$(id -u)/com.apple.identityservicesd
launchctl kickstart -k gui/$(id -u)/com.apple.imagent
imsg launch
openclaw gateway restart

#!/usr/bin/env bash
exec ssh -T messages-mac imsg "$@"

openclaw channels status --probe --channel imessage

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

​

مؤشرات مرجع الإعداد

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

​

ذو صلة

• نظرة عامة على القنوات — جميع القنوات المدعومة
• إزالة BlueBubbles ومسار iMessage عبر imsg — ملخص الإعلان والترحيل
• الانتقال من BlueBubbles — جدول تحويل الإعداد وخطوات الانتقال التفصيلية
• الإقران — مصادقة الرسائل المباشرة ومسار الإقران
• المجموعات — سلوك المحادثات الجماعية وتقييد الاستجابة بالإشارات
• توجيه القنوات — توجيه جلسات الرسائل
• الأمان — نموذج الوصول والتعزيز الأمني