1
Phê duyệt cảnh báo của macOS
2
Cho phép tìm mạng cục bộ
3
Chào mừng và thông báo bảo mật
Đọc thông báo bảo mật được hiển thị và đưa ra quyết định phù hợp
- Theo mặc định, OpenClaw là một agent cá nhân: một ranh giới dành cho 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 cần được siết chặt: tách biệt các ranh giới tin cậy, duy trì quyền truy cập công cụ ở mức tối thiểu và tuân theo hướng dẫn trong Bảo mật.
- Theo mặc định, quy trình thiết lập ban đầu cục bộ đặt cấu hình mới thành
tools.profile: "coding"để các thiết lập mới vẫn có các công cụ hệ thống tệp/runtime mà không cần hồ sơfullkhông bị giới hạn. - Nếu bật hook/webhook hoặc các nguồn cấp nội dung không đáng tin cậy khác, hãy sử dụng cấp mô hình hiện đại, mạnh mẽ và duy trì chính sách công cụ/sandbox nghiêm ngặt.
4
Cục bộ và từ xa
- Máy Mac này (chỉ cục bộ): quy trình thiết lập ban đầu cấu hình xác thực và ghi thông tin xác thực trên máy cục bộ.
- Từ xa (qua SSH/Tailnet): quy trình thiết lập ban đầu không cấu hình xác thực cục bộ;
thông tin xác thực phải có sẵn trên máy chủ Gateway. Trường token của Gateway từ xa
lưu token mà ứng dụng macOS dùng để kết nối với Gateway đó;
các giá trị SecretRef
gateway.remote.tokenhiện có được giữ nguyên cho đến khi bạn thay thế chúng. - Cấu hình sau: bỏ qua quá trình thiết lập và để ứng dụng chưa được cấu hình.
5
CLI
Thiết lập cục bộ cài đặt CLI
openclaw toàn cục thông qua npm, pnpm hoặc bun,
ưu tiên npm trước. Node vẫn là runtime được khuyên dùng cho chính Gateway.
Các bản cài đặt tương thích hiện có sẽ được tái sử dụng.6
Kết nối AI của bạn
Một Gateway đã kết nối và có sẵn mô hình agent được cấu hình sẽ bỏ qua hoàn toàn
trang này và mở giao diện người dùng agent thông thường. Quá trình thiết lập OpenClaw và nhà cung cấp
chỉ chạy cho Gateway mới hoặc chưa hoàn chỉnh.Khi Gateway đã sẵn sàng, quy trình thiết lập ban đầu sẽ tìm quyền truy cập AI mà bạn đã có:
thông tin đăng nhập Claude Code hoặc Codex,
OPENAI_API_KEY / ANTHROPIC_API_KEY, hoặc một
mô hình có khả năng sử dụng công cụ với ngữ cảnh hiệu dụng đo được ít nhất là 16K,
đã được cài đặt trên máy chủ Ollama hoặc LM Studio có thể truy cập. Hoạt động phát hiện chạy trên
máy chủ Gateway, kể cả khi ứng dụng macOS kết nối với Gateway trên Linux. Tùy chọn tốt nhất
được kiểm thử bằng một lượt hoàn thành thực tế và chỉ được lưu
sau khi phản hồi; khi kiểm thử thất bại, ứng dụng sẽ tự động thử tùy chọn tiếp theo
và hiển thị lý do tùy chọn trước đó thất bại. Nếu tìm thấy nhiều tùy chọn, bạn có thể
chuyển đổi giữa chúng trước khi tiếp tục. Hoạt động khám phá cục bộ tự động không bao giờ kéo về
hoặc tải xuống mô hình.Để sử dụng gói đăng ký Claude khi máy chủ Gateway không có thông tin đăng nhập Claude CLI, hãy chạy
claude setup-token trên bất kỳ máy nào đã cài đặt Claude Code, sau đó dán
token được in ra dưới dạng Anthropic setup-token trong Connect with an API key or
token.Các CLI Gemini CLI, Antigravity, Pi và OpenCode đã cài đặt được hiển thị để cung cấp ngữ cảnh
khi không thể chọn chúng làm tuyến suy luận có hướng dẫn có thể tái sử dụng cho quá trình thiết lập.
Gemini và Antigravity không thể thực thi bước thăm dò suy luận không dùng công cụ. Pi và
OpenCode là các bộ khung agent hoàn chỉnh thay vì các tuyến suy luận thiết lập; các tích hợp
phiên của chúng yêu cầu thiết lập runtime và Plugin riêng.Bạn cũng có thể đăng nhập thông qua luồng OAuth hoặc ghép đôi thiết bị riêng của nhà cung cấp.
Các lựa chọn tích hợp sẵn gồm OpenAI/ChatGPT, OpenRouter, GitHub Copilot, Google
Gemini CLI, xAI, MiniMax Global và CN, cùng Chutes. Danh sách này đến từ các Plugin
nhà cung cấp suy luận văn bản đang hoạt động của Gateway thay vì một danh sách cố định trong ứng dụng,
vì vậy nhà cung cấp khác có thể tham gia mà không cần thêm mã macOS dành riêng cho nhà cung cấp.Bộ chọn khóa/token thủ công sử dụng cùng một sổ đăng ký nhà cung cấp. Trong mọi tuyến,
nhà cung cấp cung cấp mô hình khởi đầu và cấu hình của mình; OpenClaw xác minh
thông tin xác thực bằng cùng một kiểm thử trực tiếp trước khi lưu hồ sơ xác thực. Nút Next
vẫn bị khóa cho đến khi một backend vượt qua kiểm thử, vì vậy cuộc trò chuyện agent đầu tiên không thể
bắt đầu nếu suy luận chưa hoạt động. Sau khi bước kiểm tra trực tiếp đó thành công, OpenClaw trở nên
khả dụng để giúp cấu hình phần còn lại của không gian làm việc, Gateway, các kênh và
những tính năng tùy chọn khác. Khi OpenClaw đưa ra một danh sách lựa chọn ngắn, ứng dụng
hiển thị các thẻ tùy chọn gốc; việc chọn một thẻ sẽ gửi lựa chọn đó, và Skip for
now luôn giữ lựa chọn ở trạng thái không bắt buộc. OpenClaw cũng khả dụng sau này trong
Settings → OpenClaw.7
Nhập bộ nhớ (hiển thị khi được phát hiện)
Đối với Gateway cục bộ, quy trình thiết lập ban đầu kiểm tra máy Mac để tìm bộ nhớ từ các công cụ AI
được hỗ trợ: bộ nhớ tự động của Claude Code, bộ nhớ hợp nhất của Codex và các tệp bộ nhớ
Hermes. Khi tìm thấy bất kỳ mục nào, trang này liệt kê từng nguồn cùng số lượng bộ nhớ
và cho phép bạn nhập các nguồn đã chọn vào không gian làm việc của agent tại
memory/imports/ để truy xuất theo chỉ mục. Các tệp đã nhập sẽ được bỏ qua và
trang này không bao giờ xuất hiện khi không có gì để nhập. Bạn có thể bỏ qua một cách an toàn;
trang nhập Bộ nhớ của bảng điều khiển cung cấp cùng chức năng nhập sau này với khả năng
kiểm soát từng tệp.8
Quyền
Chọn những quyền bạn muốn cấp cho OpenClaw
9
Hoàn tất
Sau khi suy luận vượt qua kiểm thử, OpenClaw đảm nhiệm phần thiết lập tùy chọn còn lại và có thể
chuyển bạn sang cuộc trò chuyện agent thông thường. Hoàn tất phần hướng dẫn về quyền
sẽ mở chính cuộc trò chuyện đó; ứng dụng không tạo không gian làm việc hoặc khởi chạy một
cuộc trò chuyện thiết lập agent riêng trước OpenClaw. Xem
Bootstrap để biết điều gì xảy ra trên máy chủ Gateway
trong lượt thực tế đầu tiên của agent.