macOS پر Gateway کی لائف سائیکل¶
macOS ایپ ڈیفالٹ طور پر launchd کے ذریعے Gateway کو منیج کرتی ہے اور
Gateway کو چائلڈ پروسیس کے طور پر شروع نہیں کرتی۔ یہ پہلے کنفیگرڈ پورٹ پر پہلے سے چلتے ہوئے
Gateway سے منسلک ہونے کی کوشش کرتی ہے؛ اگر کوئی دستیاب نہ ہو تو بیرونی openclaw CLI کے ذریعے launchd
سروس کو فعال کرتی ہے (کوئی ایمبیڈڈ رن ٹائم نہیں)۔ اس سے آپ کو
لاگ اِن پر قابلِ اعتماد آٹو اسٹارٹ اور کریش ہونے پر ری اسٹارٹ ملتا ہے۔
چائلڈ‑پروسیس موڈ (ایپ کے ذریعے براہِ راست Gateway شروع کرنا) آج استعمال میں نہیں ہے۔ اگر آپ کو UI کے ساتھ زیادہ مضبوط جوڑ درکار ہو تو Gateway کو دستی طور پر ٹرمینل میں چلائیں۔
بطورِ طے شدہ رویہ (launchd)¶
- ایپ فی صارف LaunchAgent انسٹال کرتی ہے جس کا لیبل
bot.molt.gatewayہے (یاbot.molt.<profile>`` جب--profile/OPENCLAW_PROFILEاستعمال کیا جائے؛ legacycom.openclaw.*` سپورٹڈ ہے)۔ - جب Local موڈ فعال ہو، ایپ اس بات کو یقینی بناتی ہے کہ LaunchAgent لوڈ ہو اور ضرورت پڑنے پر Gateway شروع کرے۔
- لاگز launchd کے gateway لاگ پاتھ پر لکھے جاتے ہیں (Debug Settings میں نظر آتے ہیں)۔
عام کمانڈز:
launchctl kickstart -k gui/$UID/bot.molt.gateway
launchctl bootout gui/$UID/bot.molt.gateway
نامزد پروفائل چلانے پر لیبل کو bot.molt.<profile> سے بدل دیں۔نامزد پروفائل چلانے پر لیبل کو bot.molt.<profile> سے بدل دیں۔
غیر دستخط شدہ dev بلڈز¶
scripts/restart-mac.sh --no-sign تیز مقامی بلڈز کے لیے ہے جب آپ کے پاس
سائننگ کیز نہ ہوں۔ launchd کو بغیر دستخط شدہ relay بائنری کی طرف اشارہ کرنے سے روکنے کے لیے، یہ:
~/.openclaw/disable-launchagentلکھتا ہے۔
scripts/restart-mac.sh کے سائن شدہ رنز اگر مارکر موجود ہو تو اس اووررائیڈ کو صاف کر دیتے ہیں۔ دستی طور پر ری سیٹ کرنے کے لیے:
rm ~/.openclaw/disable-launchagent
صرف‑اٹیچ موڈ¶
macOS ایپ کو کبھی بھی launchd انسٹال یا منیج نہ کرنے پر مجبور کرنے کے لیے، اسے
--attach-only (یا --no-launchd) کے ساتھ لانچ کریں۔ یہ ~/.openclaw/disable-launchagent سیٹ کرتا ہے،
تاکہ ایپ صرف پہلے سے چلتے ہوئے Gateway سے منسلک ہو۔ آپ Debug Settings میں بھی
اسی رویے کو ٹوگل کر سکتے ہیں۔
ریموٹ موڈ¶
ریموٹ موڈ کبھی بھی مقامی Gateway شروع نہیں کرتا۔ ایپ ریموٹ ہوسٹ تک SSH ٹنل استعمال کرتی ہے اور اسی ٹنل کے ذریعے کنیکٹ ہوتی ہے۔
ہم launchd کو کیوں ترجیح دیتے ہیں¶
- لاگ اِن پر آٹو‑اسٹارٹ۔
- بلٹ‑اِن ری اسٹارٹ/KeepAlive سیمینٹکس۔
- قابلِ پیش گوئی لاگز اور نگرانی۔
اگر کبھی حقیقی چائلڈ‑پروسیس موڈ دوبارہ درکار ہو، تو اسے ایک علیحدہ، واضح dev‑صرف موڈ کے طور پر دستاویزی شکل دی جانی چاہیے۔