Onboarding (macOS Uygulaması)¶

Bu belge, mevcut ilk çalıştırma onboarding akışını açıklar. Amaç, sorunsuz bir “0. gün” deneyimidir: Gateway’in nerede çalışacağını seçmek, kimlik doğrulamayı bağlamak, sihirbazı çalıştırmak ve ajanın kendi kendini bootstrap etmesine izin vermek.

Gateway nerede çalışır?

• Bu Mac (Yalnızca yerel): onboarding, OAuth akışlarını çalıştırabilir ve kimlik bilgilerini yerel olarak yazabilir.
• Uzak (SSH/Tailnet üzerinden): onboarding, OAuth’u yerel olarak çalıştırmaz; kimlik bilgileri gateway ana makinesinde mevcut olmalıdır.
• Daha sonra yapılandır: kurulumu atlayın ve uygulamayı yapılandırılmamış bırakın.

Gateway kimlik doğrulama ipucu: - Sihirbaz artık loopback için bile bir token üretir; bu nedenle yerel WS istemcilerinin kimlik doğrulaması gerekir. - Kimlik doğrulamayı devre dışı bırakırsanız, herhangi bir yerel süreç bağlanabilir; bunu yalnızca tamamen güvenilen makinelerde kullanın. - Çoklu makine erişimi veya loopback olmayan bağlamalar için bir token kullanın.

Onboarding, aşağıdakiler için gerekli TCC izinlerini ister:

• Otomasyon (AppleScript)
• Bildirimler
• Erişilebilirlik
• Ekran Kaydı
• Mikrofon
• Konuşma Tanıma
• Kamera
• Konum

Bu adım isteğe bağlıdır Uygulama, terminal iş akışlarının ve launchd görevlerinin kutudan çıktığı gibi çalışması için npm/pnpm üzerinden global openclaw CLI’yı kurabilir. Kurulumdan sonra uygulama, ajanın kendini tanıtabilmesi ve sonraki adımları yönlendirebilmesi için özel bir onboarding sohbet oturumu açar. Bu, ilk çalıştırma rehberliğini normal konuşmanızdan ayrı tutar. İlk ajan çalıştırması sırasında gateway ana makinesinde neler olduğunu görmek için Bootstrapping bölümüne bakın.