iMessage (قديم: imsg)

تكامل CLI خارجي قديم. ينشئ Gateway عملية imsg rpc (JSON-RPC عبر stdio).

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

1. تأكد من تسجيل الدخول إلى Messages على هذا Mac
2. قم بتثبيت imsg: brew install steipete/tap/imsg
3. قم بتكوين OpenClaw مع cliPath و dbPath
4. ابدأ Gateway واقبل أي أذونات macOS

التكوين الأدنى

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

ما هو

• قناة iMessage مدعومة بـ imsg على macOS
• توجيه حتمي: الردود تذهب دائمًا إلى iMessage
• الرسائل المباشرة تشارك الجلسة الرئيسية؛ المجموعات معزولة
• إذا اخترت، يمكن للوكيل كتابة تحديثات التكوين

كتابة التكوين

بشكل افتراضي، يُسمح لـ iMessage بكتابة تحديثات التكوين المُطلقة عبر /config set|unset.

لتعطيل ذلك:

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

المتطلبات

• macOS مع تسجيل دخول Messages
• Full Disk Access لـ OpenClaw و imsg
• إذن Automation عند الإرسال

إعداد متقدم

مستخدم macOS مخصص للبوت

إذا كنت تريد أن يرسل البوت من هوية iMessage منفصلة (والحفاظ على Messages الشخصي نظيفًا):

1. أنشئ Apple ID مخصص
2. أنشئ مستخدم macOS وقم بتسجيل الدخول إليه
3. افتح Messages في ذلك المستخدم وقم بتسجيل الدخول بـ Apple ID الجديد
4. قم بتثبيت وتكوين OpenClaw في مستخدم البوت

البديل Remote/SSH (اختياري)

إذا كنت تريد iMessage على Mac آخر، قم بتعيين cliPath إلى wrapper يقوم بتشغيل imsg على المضيف البعيد عبر SSH.

مثال wrapper:

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

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

الرسائل المباشرة

• الافتراضي: dmPolicy = "pairing"
• المرسلون المجهولون يتلقون كود إقران
• الموافقة عبر: openclaw pairing approve imessage <CODE>

المجموعات

• الافتراضي: allowlist
• يجب إضافة المجموعات صراحةً إلى التكوين

مرجع التكوين

خيارات المزود الرئيسية:

• enabled - تفعيل/تعطيل بدء تشغيل القناة
• cliPath - مسار imsg
• dbPath - مسار قاعدة بيانات Messages
• remoteHost - مضيف SSH لنقل المرفقات عبر SCP