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.

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.

Mẹo xác thực Gateway: - Trình hướng dẫn hiện tạo token ngay cả cho loopback, vì vậy các client WS cục bộ phải xác thực. - 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.

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í

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