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

​
openclaw setup

openclaw setup là điểm vào của tác nhân hệ thống. Trên hệ thống đã được cấu hình, lệnh trần openclaw setup sẽ mở một phiên trò chuyện OpenClaw tương tác. Trên hệ thống mới, lệnh này chuyển sang quy trình thiết lập ban đầu có hướng dẫn. Dùng -m/--message cho một yêu cầu hoặc --baseline để khởi tạo các thư mục cấu hình/không gian làm việc mà không dùng trình hướng dẫn. Thứ tự định tuyến:
  1. Bất kỳ tùy chọn thiết lập ban đầu nào (--wizard, --baseline, không gian làm việc, đặt lại, không tương tác, luồng, chế độ, Gateway, daemon, bỏ qua, nhập, từ xa hoặc các tùy chọn xác thực) đều chạy quy trình thiết lập ban đầu giống hệt openclaw onboard.
  2. -m/--message hoặc --yes chạy tác nhân hệ thống.
  3. Khi không có tùy chọn định tuyến, hệ thống tương tác đã được cấu hình sẽ mở OpenClaw. Một hệ thống mới sẽ chạy quy trình thiết lập ban đầu. Trên hệ thống đã được cấu hình, --json in thông tin tổng quan hệ thống ngay cả khi không có TTY; một tùy chọn thiết lập ban đầu sẽ giữ lại bản tóm tắt JSON của quy trình thiết lập ban đầu.
Trong chế độ có hướng dẫn, --workspace <dir> là không gian làm việc được đề xuất cho OpenClaw; nó chỉ được lưu sau khi bạn phê duyệt đề xuất đó. Thiết lập cơ sở, cổ điển và không tương tác sẽ lưu không gian làm việc được cung cấp thông qua luồng thông thường tương ứng. Quá trình phát hiện suy luận có hướng dẫn chạy trên máy chủ Gateway trong macOS hoặc Linux. CLI và ứng dụng macOS gọi cùng một bộ phát hiện do Gateway sở hữu, bộ này kiểm tra các mô hình đã cấu hình, thông tin đăng nhập CLI được hỗ trợ, biến môi trường khóa API và các mô hình Ollama hoặc LM Studio đã được cài đặt. Các mô hình cục bộ không bao giờ được tải xuống trong lượt tự động này. Các runtime cục bộ được phát hiện sẽ tự động được kiểm thử sau các ứng viên CLI và khóa API; khi có nhiều mô hình cục bộ, OpenClaw ưu tiên họ mô hình instruct có khả năng gọi công cụ mạnh nhất. Ứng viên được chọn phải trả lời một yêu cầu hoàn tất thực tế trước khi cấu hình nhà cung cấp và mô hình của nó được lưu. Các CLI Gemini, Antigravity, Pi và OpenCode đã cài đặt cũng được báo cáo khi chúng không thể đóng vai trò là tuyến suy luận có thể tái sử dụng cho thiết lập có hướng dẫn. setup chấp nhận các cờ thiết lập ban đầu giống như openclaw onboard, bao gồm xác thực (--auth-choice, --token, các cờ khóa nhà cung cấp), Gateway (--gateway-port, --gateway-bind, --gateway-auth, --install-daemon), Tailscale (--tailscale), đặt lại (--reset, --reset-scope), luồng (--flow quickstart|advanced|manual|import) và các cờ bỏ qua (--skip-channels, --skip-skills, --skip-bootstrap, --skip-search, --skip-health, --skip-ui, --skip-hooks). Truyền --tui để dùng cùng lối thoát qua terminal như openclaw onboard --tui. Xem Thiết lập ban đầu và Tự động hóa CLI để biết tài liệu tham khảo đầy đủ về các cờ và các ví dụ không tương tác. openclaw onboard --modern vẫn là một điểm vào tương thích cho cùng trợ lý OpenClaw có cổng kiểm soát suy luận.
openclaw setup dành cho các bản cài đặt có cấu hình có thể thay đổi. Trong chế độ Nix (OPENCLAW_NIX_MODE=1), OpenClaw từ chối ghi dữ liệu thiết lập vì tệp cấu hình do Nix quản lý. Hãy dùng Hướng dẫn bắt đầu nhanh nix-openclaw chính chủ hoặc cấu hình nguồn tương đương cho một gói Nix khác.

​
Tùy chọn

--classic và --non-interactive loại trừ lẫn nhau: chế độ cổ điển mở trình hướng dẫn có lời nhắc, còn thiết lập không tương tác sử dụng tuyến tự động hóa. Trong thiết lập ban đầu tương tác, --remote-url và --remote-token điền sẵn bước Gateway từ xa và được ưu tiên hơn các giá trị từ xa đã lưu trong lần chạy đó. Việc thay đổi URL không tái sử dụng thông tin xác thực đã lưu trừ khi bạn cũng truyền token. Token vẫn được che và sử dụng chế độ lưu trữ văn bản thuần hoặc SecretRef do trình hướng dẫn chọn.

​
Chế độ cơ sở

openclaw setup --baseline giữ nguyên hành vi cũ chỉ dành cho chế độ cơ sở: nó tạo các thư mục cấu hình, không gian làm việc và phiên, sau đó thoát mà không chạy thiết lập ban đầu. Nó chấp nhận --workspace và các tùy chọn điều khiển đầu ra không gây ảnh hưởng, nhưng từ chối các tùy chọn thiết lập ban đầu, Gateway, xác thực, đặt lại hoặc daemon được chỉ định rõ thay vì âm thầm bỏ qua chúng.

​
Ví dụ

​
Ghi chú

  • Sau khi thiết lập cơ sở, chạy openclaw onboard để thực hiện toàn bộ hành trình có hướng dẫn, openclaw configure để thực hiện các thay đổi có mục tiêu hoặc openclaw channels add để thêm tài khoản kênh.
  • Nếu phát hiện trạng thái Hermes, thiết lập ban đầu tương tác có thể tự động đề xuất di chuyển. Quá trình thiết lập ban đầu có nhập yêu cầu một thiết lập mới; hãy dùng Di chuyển để lập kế hoạch chạy thử, sao lưu và dùng chế độ ghi đè bên ngoài quy trình thiết lập ban đầu.

​
Liên quan