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

# 入門引導（macOS 應用程式）

# 入門引導（macOS 應用程式）

This doc describes the **current** first‑run onboarding flow. 目標是一個
順暢的「第 0 天」體驗：選擇 Gateway 的執行位置、連接驗證、執行精靈，並讓代理自行完成啟動。
如需了解入門流程的整體概覽，請參閱 [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="請閱讀顯示的安全性注意事項並依情況決定">
      <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 閘道器** 在哪裡執行？

    * **此 Mac（僅限本機）：** 導覽流程可以執行 OAuth 流程並在本機寫入憑證。
    * **遠端（透過 SSH/Tailnet）：** 入門引導**不會**在本機執行 OAuth；認證資料必須已存在於閘道器主機。
    * **稍後設定：** 略過設定，讓應用程式保持未設定狀態。

    <Tip>
      **Gateway 驗證提示：**

      * 精靈現在即使在 loopback 情況下也會產生一個 **token**，因此本機 WS 用戶端必須進行驗證。
      * If you disable auth, any local process can connect; use that only on fully trusted machines.
      * If you disable auth, any local process can connect; use that only on fully trusted machines.
      * 對於多機器存取或非 loopback 綁定，請使用 **token**。
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="選擇要授予 OpenClaw 的權限">
      <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>

    入門引導會請求所需的 TCC 權限，包括：

    * 自動化（AppleScript）
    * 通知
    * 無障礙
    * 螢幕錄製
    * 麥克風
    * 語音辨識
    * 相機
    * 位置資訊
  </Step>

  <Step title="CLI">
    <Info>
      14. 此步驟為選用
    </Info>

    應用程式可透過 npm/pnpm 安裝全域的 `openclaw` CLI，讓終端機工作流程與 launchd 工作能立即使用。
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    設定完成後，應用程式會開啟一個專用的新手引導聊天工作階段，讓代理
    自我介紹並引導後續步驟。 這能讓首次執行的引導內容
    與你的一般對話分開。 請參閱 [Bootstrapping](/start/bootstrapping)，了解
    在第一次代理執行期間，閘道主機上會發生什麼事。
  </Step>
</Steps>