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

# Hướng dẫn ban đầu (Ứng dụng macOS)

# Hướng dẫn ban đầu (Ứng dụng macOS)

Tài liệu này mô tả luồng onboarding chạy lần đầu **hiện tại**. Mục tiêu là một trải nghiệm “ngày 0” mượt mà: chọn nơi Gateway chạy, kết nối xác thực, chạy trình hướng dẫn, và để agent tự khởi tạo.
Để xem tổng quan về các cách khởi tạo, hãy xem [Tổng quan khởi tạo](/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="Đọc thông báo bảo mật được hiển thị và quyết định cho phù hợp">
      <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** chạy ở đâu?

    * **Máy này (chỉ cục bộ):** hướng dẫn ban đầu có thể chạy các luồng OAuth và ghi thông tin xác thực
      cục bộ.
    * **Từ xa (qua SSH/Tailnet):** hướng dẫn ban đầu **không** chạy OAuth cục bộ;
      thông tin xác thực phải tồn tại trên máy chủ gateway.
    * **Cấu hình sau:** bỏ qua thiết lập và để ứng dụng ở trạng thái chưa cấu hình.

    <Tip>
      **Gateway auth tip:**

      * The wizard now generates a **token** even for loopback, so local WS clients must authenticate.
      * Nếu bạn tắt xác thực, bất kỳ tiến trình cục bộ nào cũng có thể kết nối; chỉ dùng cách này trên các máy hoàn toàn đáng tin cậy.
      * Dùng **token** cho truy cập đa máy hoặc khi bind không phải loopback.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Chọn các quyền bạn muốn cấp cho 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>

    Hướng dẫn ban đầu yêu cầu các quyền TCC cần thiết cho:

    * Tự động hóa (AppleScript)
    * Thông báo
    * Trợ năng
    * Ghi màn hình
    * Micro
    * Nhận dạng giọng nói
    * Máy ảnh
    * Vị trí
  </Step>

  <Step title="CLI">
    <Info>
      Bước này là tùy chọn
    </Info>

    Ứng dụng có thể cài đặt CLI `openclaw` toàn cục qua npm/pnpm để các
    quy trình làm việc trên terminal và các tác vụ launchd hoạt động ngay.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    Sau khi thiết lập, ứng dụng sẽ mở một phiên chat onboarding riêng để agent tự giới thiệu và hướng dẫn các bước tiếp theo. Điều này giúp tách hướng dẫn lần chạy đầu khỏi các cuộc trò chuyện thông thường của bạn. Xem [Bootstrapping](/start/bootstrapping) để biết điều gì xảy ra trên máy chủ gateway trong lần chạy agent đầu tiên.
  </Step>
</Steps>