Ana içeriğe atla

​
Onboarding (macOS Uygulaması)

Bu belge, mevcut ilk çalıştırma kurulum akışını açıklar. Amaç; akıcı bir “0. gün” deneyimi sunmaktır: Gateway’in nerede çalışacağını seçin, kimlik doğrulamayı bağlayın, sihirbazı çalıştırın ve ajanın kendini önyüklemesine izin verin. Onboarding yollarına genel bakış için bkz. Onboarding Genel Bakış.
1

macOS uyarısını onaylayın

2

Yerel ağları bulma iznini onaylayın

3

Karşılama ve güvenlik bildirimi

Güvenlik güven modeli:
  • Varsayılan olarak OpenClaw kişisel bir ajandır: tek bir güvenilen operatör sınırı.
  • Paylaşılan/çok kullanıcılı kurulumlar sıkılaştırma gerektirir (güven sınırlarını ayırın, araç erişimini minimumda tutun ve Security belgesini izleyin).
  • Yerel onboarding artık yeni config’lerde varsayılan olarak tools.profile: "coding" kullanır; böylece yeni yerel kurulumlar, sınırsız full profilini zorunlu kılmadan dosya sistemi/çalışma zamanı araçlarını korur.
  • Hooks/webhooks veya güvenilmeyen başka içerik beslemeleri etkinse, güçlü ve modern bir model katmanı kullanın ve araç politikasını/sandboxing’i sıkı tutun.
4

Yerel ve Uzak

Gateway nerede çalışıyor?
  • Bu Mac’te (yalnızca yerel): onboarding, kimlik doğrulamayı yapılandırabilir ve kimlik bilgilerini yerel olarak yazabilir.
  • Uzakta (SSH/Tailnet üzerinden): onboarding yerel kimlik doğrulamayı yapılandırmaz; kimlik bilgilerinin gateway host üzerinde mevcut olması gerekir.
  • 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 oluşturur; bu yüzden yerel WS istemcileri kimlik doğrulaması yapmalıdır.
  • 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.
  • Çok makineli erişim veya loopback dışı bind’ler için bir token kullanın.
5

İzinler

Onboarding, şunlar için gereken 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, global openclaw CLI aracını npm, pnpm veya bun üzerinden kurabilir. Önce npm’yi, sonra pnpm’yi, yalnızca tespit edilen paket yöneticisi buysa en son bun’ı tercih eder. Gateway çalışma zamanı için Node önerilen yol olmaya devam eder.
7

Onboarding Sohbeti (ayrı oturum)

Kurulumdan sonra uygulama, ajanın kendini tanıtması ve sonraki adımları yönlendirmesi için ayrı bir onboarding sohbet oturumu açar. Bu, ilk çalıştırma yönlendirmesini normal sohbetinizden ayrı tutar. İlk ajan çalıştırmasında gateway host üzerinde neler olduğunu görmek için Bootstrapping belgesine bakın.