Chuyển đến nội dung chính

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

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

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

Permissions

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í
6

CLI

Bước này là tùy chọn
Ứ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.
7

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 để biết điều gì xảy ra trên máy chủ gateway trong lần chạy agent đầu tiên.