> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding (macOS Uygulaması)

# 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](/start/onboarding-overview).

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=52ce8b835daf7a29b63c3ee7f4a0308a" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Approve find local networks">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=898d91d6350aef17eb26d54f2aae7398" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Welcome and security notice">
    <Frame caption="Görüntülenen güvenlik bildirimini okuyun ve buna göre karar verin">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=f5c2f45dfb79fb3102f3b00349685c5e" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>
  </Step>

  <Step title="Local vs Remote">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=280e34bced7bf879d9b6f74a77abcda0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

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

    <Tip>
      **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.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="OpenClaw’a hangi izinleri vermek istediğinizi seçin">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=fe49a0e85fad11452f3ee292d78e2415" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

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

    * Otomasyon (AppleScript)
    * Bildirimler
    * Erişilebilirlik
    * Ekran Kaydı
    * Mikrofon
    * Konuşma Tanıma
    * Kamera
    * Konum
  </Step>

  <Step title="CLI">
    <Info>
      Bu adım isteğe bağlıdır
    </Info>

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

  <Step title="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](/start/bootstrapping) bölümüne bakın.
  </Step>
</Steps>