> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# دورة حياة Gateway على macOS

يدير تطبيق macOS **Gateway عبر launchd** افتراضياً ولا يشغّل
Gateway كعملية فرعية. يحاول أولاً الاتصال بـ Gateway قيد التشغيل
بالفعل على المنفذ المكوّن؛ وإذا لم يكن أي منها قابلاً للوصول، فإنه يفعّل خدمة launchd
عبر CLI `openclaw` الخارجي (من دون وقت تشغيل مضمّن). يوفّر لك ذلك
بدءاً تلقائياً موثوقاً عند تسجيل الدخول وإعادة التشغيل عند حدوث الأعطال.

وضع العملية الفرعية (تشغيل Gateway مباشرةً بواسطة التطبيق) **ليس قيد الاستخدام** اليوم.
إذا كنت تحتاج إلى اقتران أوثق بواجهة المستخدم، فشغّل Gateway يدوياً في طرفية.

## السلوك الافتراضي (launchd)

* يثبّت التطبيق LaunchAgent لكل مستخدم بالوسم `ai.openclaw.gateway`
  (أو `ai.openclaw.<profile>` عند استخدام `--profile`/`OPENCLAW_PROFILE`؛ ويدعم `com.openclaw.*` القديم).
* عند تفعيل الوضع المحلي، يتأكد التطبيق من تحميل LaunchAgent ويبدأ
  Gateway عند الحاجة.
* تُكتب السجلات إلى مسار سجل launchd الخاص بـ Gateway (مرئي في إعدادات التصحيح).

الأوامر الشائعة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway
```

استبدل الوسم بـ `ai.openclaw.<profile>` عند تشغيل ملف تعريف مسمّى.

## إصدارات التطوير غير الموقعة

`scripts/restart-mac.sh --no-sign` مخصص للإصدارات المحلية السريعة عندما لا تكون لديك
مفاتيح توقيع. لمنع launchd من الإشارة إلى ملف ثنائي مرحّل غير موقّع، فإنه:

* يكتب `~/.openclaw/disable-launchagent`.

تشغيل `scripts/restart-mac.sh` الموقّع يمسح هذا التجاوز إذا كانت العلامة
موجودة. لإعادة الضبط يدوياً:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rm ~/.openclaw/disable-launchagent
```

## وضع الإرفاق فقط

لإجبار تطبيق macOS على **عدم تثبيت launchd أو إدارته مطلقاً**، شغّله باستخدام
`--attach-only` (أو `--no-launchd`). يضبط هذا `~/.openclaw/disable-launchagent`،
لذلك لا يرفق التطبيق إلا بـ Gateway قيد التشغيل بالفعل. يمكنك تبديل السلوك نفسه
في إعدادات التصحيح.

## الوضع البعيد

لا يبدأ الوضع البعيد Gateway محلياً أبداً. يستخدم التطبيق نفق SSH إلى
المضيف البعيد ويتصل عبر ذلك النفق.

## لماذا نفضل launchd

* بدء تلقائي عند تسجيل الدخول.
* دلالات إعادة التشغيل/KeepAlive المضمّنة.
* سجلات وإشراف يمكن التنبؤ بهما.

إذا دعت الحاجة مرة أخرى إلى وضع عملية فرعية حقيقي، فيجب توثيقه كوضع
منفصل وصريح ومخصص للتطوير فقط.

## ذات صلة

* [تطبيق macOS](/ar/platforms/macos)
* [دليل تشغيل Gateway](/ar/gateway)