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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tài liệu này mô tả luồng thiết lập lần chạy đầu tiên hiện tại. Mục tiêu là 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 động ban đầu. Để xem tổng quan chung về các lộ trình onboarding, hãy xem Tổng quan onboarding.
1

Phê duyệt cảnh báo macOS

2

Phê duyệt tìm mạng cục bộ

3

Chào mừng và thông báo bảo mật

Mô hình tin cậy bảo mật:
  • Theo mặc định, OpenClaw là một agent cá nhân: một ranh giới người vận hành đáng tin cậy.
  • Các thiết lập dùng chung/nhiều người dùng yêu cầu khóa chặt (tách ranh giới tin cậy, giữ quyền truy cập công cụ ở mức tối thiểu và làm theo Bảo mật).
  • Onboarding cục bộ hiện mặc định các cấu hình mới thành tools.profile: "coding" để các thiết lập cục bộ mới vẫn giữ công cụ hệ thống tệp/runtime mà không buộc dùng hồ sơ full không hạn chế.
  • Nếu hooks/webhooks hoặc các nguồn nội dung không đáng tin cậy khác được bật, hãy dùng một tầng mô hình hiện đại mạnh và giữ chính sách công cụ/sandboxing nghiêm ngặt.
4

Cục bộ so với từ xa

Gateway chạy ở đâu?
  • Máy Mac này (chỉ cục bộ): onboarding có thể cấu hình xác thực và ghi thông tin xác thực cục bộ.
  • Từ xa (qua SSH/Tailnet): onboarding không cấu hình xác thực 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 chưa được cấu hình.
Mẹo xác thực Gateway:
  • Trình hướng dẫn hiện tạo một token ngay cả cho loopback, vì vậy các máy khách 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 đó trên các máy hoàn toàn đáng tin cậy.
  • Dùng token cho truy cập nhiều máy hoặc các bind không phải loopback.
5

Quyền

Onboarding 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
  • Micrô
  • Nhận dạng giọng nói
  • Camera
  • 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 hoặc bun. Ứng dụng ưu tiên npm trước, rồi pnpm, rồi bun nếu đó là trình quản lý gói duy nhất được phát hiện. Đối với runtime Gateway, Node vẫn là lộ trình được khuyến nghị.
7

Trò chuyện onboarding (phiên chuyên dụng)

Sau khi thiết lập, ứng dụng mở một phiên trò chuyện onboarding chuyên dụng để agent có thể tự giới thiệu và hướng dẫn các bước tiếp theo. Điều này giữ phần hướng dẫn lần chạy đầu tiên tách biệt khỏi cuộc trò chuyện thông thường của bạn. Xem Khởi động ban đầu để biết điều gì xảy ra trên máy chủ gateway trong lần chạy agent đầu tiên.

​
Liên quan