Ana içeriğe atla

​
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. Onboarding yollarına genel bir bakış için bkz. Onboarding Overview.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

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.
5

Permissions

Onboarding, aşağıdakiler için gerekli TCC izinlerini ister:
  • Otomasyon (AppleScript)
  • Bildirimler
  • Erişilebilirlik
  • Ekran Kaydı
  • Mikrofon
  • Konuşma Tanıma
  • Kamera
  • Konum
6

CLI

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.
7

Onboarding Chat (dedicated session)

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.