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

التطبيق المرافق لنظام macOS

إعداد التطوير لنظام macOS

يغطي هذا الدليل الخطوات اللازمة لبناء وتشغيل تطبيق OpenClaw لنظام macOS من المصدر.

المتطلبات الأساسية​

قبل بناء التطبيق، تأكد من تثبيت ما يلي:

  1. Xcode 26.2+: مطلوب لتطوير Swift.
  2. Node.js 22+ & pnpm: مطلوب للبوابة (gateway) و CLI ونصوص التغليف.

1. تثبيت التبعيات​

قم بتثبيت التبعيات العامة للمشروع:

pnpm install

2. بناء وتغليف التطبيق​

لبناء تطبيق macOS وتغليفه في dist/OpenClaw.app، قم بتشغيل:

./scripts/package-mac-app.sh

إذا لم يكن لديك شهادة Apple Developer ID، فسيستخدم النص تلقائيًا التوقيع المخصص (ad-hoc) (-). لأوضاع التشغيل للتطوير، وأعلام التوقيع، واستكشاف أخطاء Team ID، راجع ملف README الخاص بتطبيق macOS: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

ملاحظة: قد تسبب التطبيقات الموقعة مخصصًا ظهور مطالبات أمنية. إذا تعطل التطبيق فورًا مع رسالة "Abort trap 6"، راجع قسم استكشاف الأخطاء وإصلاحها.

3. تثبيت CLI​

يتوقع تطبيق macOS تثبيت openclaw CLI عالميًا لإدارة المهام في الخلفية. لتثبيته (موصى به):

  1. افتح تطبيق OpenClaw.
  2. انتقل إلى علامة تبويب الإعدادات General.
  3. انقر على "Install CLI".

بدلاً من ذلك، يمكنك تثبيته يدويًا:

npm install -g openclaw@<version>

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

فشل البناء: عدم تطابق أدوات التطوير أو SDK​

يتوقع بناء تطبيق macOS أحدث إصدار من macOS SDK وأدوات Swift 6.2. التبعيات النظامية (مطلوبة):

  • أحدث إصدار من macOS متاح في تحديث البرامج (مطلوب بواسطة Xcode 26.2 SDKs)
  • Xcode 26.2 (أدوات Swift 6.2)

الفحوصات:

xcodebuild -version
xcrun swift --version

إذا كانت الإصدارات غير متطابقة، قم بتحديث macOS/Xcode وأعد تشغيل عملية البناء.

تعطل التطبيق عند منح الإذن​

إذا تعطل التطبيق عند محاولة السماح بالوصول إلى التعرف على الكلام أو الميكروفون، فقد يكون السبب هو ذاكرة تخزين مؤقت تالفة لـ TCC أو عدم تطابق في التوقيع. الإصلاح:

  1. إعادة تعيين أذونات TCC:

    نسخ

    tccutil reset All ai.openclaw.mac.debug

  2. إذا فشل ذلك، قم بتغيير BUNDLE_ID مؤقتًا في ملف scripts/package-mac-app.sh لإجبار النظام على التعامل معه كـ "بداية نظيفة".

البوابة "جارٍ البدء..." بشكل غير منته​

إذا ظل حالة البوابة على "جارٍ البدء..."، تحقق مما إذا كانت هناك عملية زومبي تحتجز المنفذ:

openclaw gateway status
openclaw gateway stop

# إذا كنت لا تستخدم LaunchAgent (وضع التطوير / تشغيل يدوي)، ابحث عن المستمع:
lsof -nP -iTCP:18789 -sTCP:LISTEN

إذا كان تشغيل يدوي يحتجز المنفذ، أوقف تلك العملية (Ctrl+C). كحل أخير، أوقف معرف العملية (PID) الذي وجدته أعلاه.

Raspberry Piشريط القائمة