إعداد المطوّرين على macOS
أنشئ تطبيق OpenClaw لنظام macOS وشغّله من المصدر.المتطلبات الأساسية
- Xcode 26.2+ (سلسلة أدوات Swift 6.2)، على أحدث إصدار متاح من macOS في Software Update.
- Node.js 24.15+ وpnpm للـ Gateway والـ CLI ونصوص الحزم. يعمل Node 22.22.3+ أيضًا.
1. تثبيت التبعيات
2. إنشاء التطبيق وتحزيمه
dist/OpenClaw.app. عند عدم توفر شهادة Apple Developer ID، يعود
النص البرمجي إلى التوقيع المخصص.
للاطلاع على أوضاع تشغيل التطوير، وخيارات التوقيع، واستكشاف أخطاء Team ID وإصلاحها، راجع
apps/macos/README.md.
دورة تطوير سريعة من جذر المستودع: scripts/restart-mac.sh (أضف --no-sign لإجراء
توقيع مخصص؛ لا تستمر أذونات TCC مع --no-sign).
قد تؤدي التطبيقات الموقّعة توقيعًا مخصصًا إلى ظهور مطالبات أمنية. إذا تعطّل التطبيق
فورًا مع “Abort trap 6”، فراجع استكشاف الأخطاء وإصلاحها.
3. تثبيت CLI وGateway
يتضمن التطبيق المحزّم مثبّتscripts/install-cli.sh القياسي. في ملف تعريف
جديد، اختر This Mac أثناء الإعداد الأولي؛ يثبّت التطبيق CLI وبيئة التشغيل
المتطابقتين في مساحة المستخدم قبل بدء معالج Gateway.
للاستعادة اليدوية في بيئة التطوير، ثبّت CLI المطابق بنفسك:
pnpm add -g openclaw@<version> وbun add -g openclaw@<version>
أيضًا. يظل Node بيئة التشغيل الموصى بها للـ Gateway نفسه.
استكشاف الأخطاء وإصلاحها
فشل الإنشاء: عدم تطابق سلسلة الأدوات أو SDK
يتطلب إنشاء تطبيق macOS أحدث إصدار من macOS SDK وسلسلة أدوات Swift 6.2 (Xcode 26.2+).تعطّل التطبيق عند منح الإذن
إذا تعطّل التطبيق عند محاولة السماح بالوصول إلى Speech Recognition أو Microphone، فقد يكون السبب ذاكرة تخزين مؤقت تالفة لـ TCC أو عدم تطابق التوقيع.-
أعد تعيين أذونات TCC لمعرّف حزمة تصحيح الأخطاء:
-
إذا فشل ذلك، فغيّر مؤقتًا
BUNDLE_IDفيscripts/package-mac-app.shلإجبار macOS على البدء من حالة نظيفة.