openclaw CLI kurulumunu bekler, Gateway’i alt süreç olarak başlatmaz ve Gateway’in çalışır durumda kalması için kullanıcı başına bir launchd servisini yönetir (veya zaten çalışan mevcut bir yerel Gateway varsa ona bağlanır).
Otomatik kurulum
Yeni bir Mac’te, ilk kurulum sırasında Bu Mac seçeneğini seçin. Uygulama, Gateway sihirbazından önce imzalı, paketlenmiş yükleyicisini çalıştırır;~/.openclaw altına kullanıcı alanı Node çalışma zamanını ve eşleşen openclaw CLI’ı kurar, ardından kullanıcı başına launchd servisini kurup başlatır. Bu yol Terminal, Homebrew veya yönetici erişimi gerektirmez.
Uygulama, Node veya Gateway yükünü değil, yükleyici betiğini paket halinde sunar. Bu nedenle kurulum, çalışma zamanını ve eşleşen OpenClaw paketini indirmek için internet bağlantısı gerektirir.
Elle kurtarma
Elle kurulum için Node 24 önerilir. Şu anda22.19+ olan Node 22 LTS de çalışır. Ardından openclaw paketini küresel olarak kurun:
Launchd (LaunchAgent olarak Gateway)
Etiket:ai.openclaw.gateway(veyaai.openclaw.<profile>; eskicom.openclaw.*kalabilir)
~/Library/LaunchAgents/ai.openclaw.gateway.plist(veya~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
- macOS uygulaması, Yerel modda LaunchAgent kurulumunu/güncellemesini üstlenir.
- CLI da bunu kurabilir:
openclaw gateway install.
- “OpenClaw Etkin”, LaunchAgent’ı etkinleştirir/devre dışı bırakır.
- Uygulamadan çıkmak gateway’i durdurmaz (launchd onu canlı tutar).
- Yapılandırılmış bağlantı noktasında zaten bir Gateway çalışıyorsa, uygulama yeni bir tane başlatmak yerine ona bağlanır.
- launchd stdout:
~/Library/Logs/openclaw/gateway.log(profillergateway-<profile>.logkullanır) - launchd stderr: bastırılır
Sürüm uyumluluğu
macOS uygulaması, Gateway sürümünü kendi sürümüyle karşılaştırarak kontrol eder. Mevcut bir CLI eksik veya uyumsuz olduğunda, ilk kurulum otomatik olarak yönetilen kurulumu çalıştırır. Kurulumu tekrarlamak için Kurulumu yeniden dene seçeneğini veya harici bir CLI’ı onardıktan sonra Yeniden kontrol et seçeneğini kullanın.macOS’ta durum dizini
OpenClaw durumunu yerel, eşitlenmeyen bir diskte tutun. iCloud Drive ve diğer bulutla eşitlenen klasörlerden kaçının; çünkü eşitleme gecikmesi ve dosya kilitleri oturumları, kimlik bilgilerini ve Gateway durumunu etkileyebilir. Yalnızca geçersiz kılma gerektiğindeOPENCLAW_STATE_DIR değerini yerel bir yola ayarlayın. openclaw doctor, yaygın bulutla eşitlenen durum yolları hakkında uyarır ve yerel depolamaya geri taşımayı önerir. Bkz.
ortam değişkenleri ve
Doctor.
Uygulama bağlantısını hata ayıklama
Uygulamanın kullandığı aynı Gateway WebSocket el sıkışmasını ve keşif mantığını çalıştırmak için bir kaynak checkout’undan macOS hata ayıklama CLI’ını kullanın:connect, --url, --token, --timeout ve --json kabul eder. discover, --timeout, --json ve --include-local kabul eder. CLI keşfini uygulama tarafındaki bağlantı sorunlarından ayırmanız gerektiğinde keşif çıktısını openclaw gateway discover --json ile karşılaştırın.