🦞
تكامل القنوات

ربط OpenClaw بـ iMessage

استخدم مساعدك الذكي مباشرة عبر تطبيق الرسائل من Apple على macOS. يدعم كلاً من iMessage و SMS.

macOS فقط

تكامل iMessage يتطلب macOS مع تطبيق الرسائل مكوّناً. يستخدم أداة imsg CLI للقراءة من قاعدة بيانات الرسائل المحلية.

لماذا تستخدم iMessage؟
  • +تكامل Apple الأصلي — يعمل مع تطبيق الرسائل الموجود لديك
  • +iMessage + SMS — يدعم كلا البروتوكولين بسلاسة
  • +إيصالات القراءة — اعرف متى تُسلّم وتُقرأ الرسائل
  • +ردود الفعل — ردود فعل iMessage مدعومة
  • +المحادثات الجماعية — المشاركة في المحادثات الجماعية
  • +البوابة البعيدة — يمكن العمل عبر SSH إلى Mac بعيد
المتطلبات
  • 1.
    macOS

    مع تطبيق الرسائل مكوّناً ومسجّل الدخول بمعرّف Apple الخاص بك

  • 2.
    صلاحية الوصول الكامل للقرص

    مطلوب لـ OpenClaw لقراءة ~/Library/Messages/chat.db

  • 3.
    أداة imsg CLI

    أداة سطر الأوامر للتفاعل مع الرسائل

خطوات الإعداد

1

تثبيت imsg CLI

ثبّت أداة سطر الأوامر imsg التي يستخدمها OpenClaw للتفاعل مع الرسائل:

brew install imsg

أو حمّل من صفحة إصدارات imsg على GitHub

2

منح الوصول الكامل للقرص

يحتاج OpenClaw صلاحية لقراءة قاعدة بيانات الرسائل:

  • - افتح إعدادات النظام (أو تفضيلات النظام)
  • - اذهب إلى الخصوصية والأمان > الوصول الكامل للقرص
  • - انقر على زر + وأضف Terminal (أو iTerm)
  • - أضف أيضاً ملف OpenClaw التنفيذي إذا كان يعمل كبرنامج ثنائي
3

تكوين OpenClaw

أضف تكوين iMessage إلى ملف openclaw.json:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "allowFrom": ["+15555550123", "user@example.com"]
    }
  }
}
4

إعداد allowFrom

حدد من يمكنه التفاعل مع البوت الخاص بك:

  • - أرقام الهاتف مع رمز البلد: +15555550123
  • - معرّفات Apple (عناوين البريد الإلكتروني): user@example.com
5

اختبار الاتصال

تحقق من عمل قناة iMessage:

openclaw channels status imessage

ثم أرسل رسالة من جهة اتصال مسموحة لاختبار التكامل.

التكوين المتقدم

جميع خيارات التكوين لقناة iMessage:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "remoteHost": "user@gateway-host",
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123", "user@example.com"],
      "historyLimit": 50,
      "includeAttachments": false,
      "mediaMaxMb": 16,
      "service": "auto",
      "region": "US"
    }
  }
}
  • cliPath — مسار ملف imsg CLI التنفيذي
  • dbPath — مسار قاعدة بيانات الرسائل
  • remoteHost — مضيف SSH لإعداد البوابة البعيدة
  • dmPolicy — كيفية التعامل مع الرسائل المباشرة
  • allowFrom — أرقام الهواتف أو معرّفات Apple المسموح لها بالمراسلة
  • historyLimit — عدد الرسائل لتضمينها كسياق
  • includeAttachments — تفعيل معالجة المرفقات
  • mediaMaxMb — الحد الأقصى لحجم المرفقات بالميجابايت
  • service — إجبار iMessage أو SMS، أو استخدام تلقائي
  • region — المنطقة لتنسيق رقم الهاتف
إعداد البوابة البعيدة (اختياري)

إذا أردت تشغيل OpenClaw على خادم لكن الوصول لـ iMessage من Mac في المنزل، يمكنك استخدام SSH:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - تأكد من إعداد مصادقة مفتاح SSH
  • - يجب أن يكون Mac دائماً قيد التشغيل ومتصلاً
  • - يجب تكوين imsg والوصول الكامل للقرص على Mac
الميزات المدعومة
متاحإيصالات القراءة
متاحردود فعل iMessage
متاحالمحادثات الجماعية
متاحدعم SMS
اختياريالمرفقات (اختياري)
متاحسجل الرسائل
استكشاف الأخطاء وإصلاحها

رفض الصلاحية عند قراءة chat.db؟

تأكد من منح الوصول الكامل للقرص لـ Terminal/iTerm وملف OpenClaw التنفيذي. قد تحتاج لإعادة تشغيل الطرفية بعد منح الوصول.

البوت لا يستجيب للرسائل؟

تحقق من أن رقم الهاتف أو معرّف Apple في allowFrom يتطابق تماماً. أرقام الهواتف تحتاج + ورمز البلد.

لا يمكن العثور على chat.db؟

المسار الافتراضي هو ~/Library/Messages/chat.db. تأكد من فتح تطبيق الرسائل مرة واحدة على الأقل وأنك مسجّل الدخول.

أمر imsg غير موجود؟

تأكد من تثبيت imsg وأنه في PATH الخاص بك. يمكنك تحديد المسار الكامل في cliPath.

البوابة البعيدة لا تتصل؟

تحقق من عمل مصادقة مفتاح SSH مع ssh user@host وأن Mac البعيد لديه imsg مثبت مع الوصول الكامل للقرص.

تم ربط iMessage!

أضف المزيد من القنوات أو كوّن المهارات لتخصيص مساعدك الذكي.

إضافة WhatsAppاستكشاف المهارات