> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Thiết lập # `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 ` 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](/vi/cli/onboard) và [Tự động hóa CLI](/vi/start/wizard-cli-automation) để 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](https://github.com/openclaw/nix-openclaw#quick-start) 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 | Cờ | Mô tả | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `-m, --message ` | Chạy một yêu cầu OpenClaw. | | `--yes` | Phê duyệt việc ghi cấu hình lâu dài cho một yêu cầu `--message`. | | `--workspace ` | Đề xuất không gian làm việc trong chế độ có hướng dẫn; được lưu trực tiếp bởi thiết lập cơ sở, cổ điển và không tương tác. | | `--baseline` | Tạo các thư mục cấu hình/không gian làm việc/phiên cơ sở mà không thiết lập ban đầu. | | `--wizard` | Buộc chạy thiết lập ban đầu tương tác. | | `--tui` | Dùng lối thoát qua terminal thay vì chuyển giao qua trình duyệt. | | `--non-interactive` | Chạy thiết lập ban đầu mà không có lời nhắc. | | `--accept-risk` | Xác nhận rủi ro truy cập của tác nhân trên toàn hệ thống; bắt buộc khi dùng `--non-interactive`. | | `--mode ` | Chế độ thiết lập ban đầu: `local` hoặc `remote`. | | `--flow ` | Luồng thiết lập ban đầu: `quickstart`, `advanced`, `manual` hoặc `import`. | | `--reset` | Đặt lại cấu hình + thông tin xác thực + phiên trước khi thiết lập ban đầu (chỉ gồm không gian làm việc khi dùng `--reset-scope full`). | | `--reset-scope ` | Phạm vi đặt lại: `config`, `config+creds+sessions` hoặc `full`. | | `--import-from ` | Nhà cung cấp di chuyển sẽ chạy trong quá trình thiết lập ban đầu. | | `--import-source ` | Thư mục chính của tác nhân nguồn cho `--import-from`. | | `--import-secrets` | Nhập các bí mật được hỗ trợ trong quá trình di chuyển khi thiết lập ban đầu. | | `--remote-url ` | URL WebSocket của Gateway từ xa. | | `--remote-token ` | Token của Gateway từ xa (không bắt buộc). | | `--json` | Hệ thống đã cấu hình: tổng quan OpenClaw. Tuyến thiết lập ban đầu: bản tóm tắt thiết lập ban đầu. | `--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ụ ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw setup openclaw setup -m "trạng thái" openclaw setup -m "khởi động lại gateway" --yes openclaw setup --json openclaw setup --wizard openclaw setup --baseline openclaw setup --workspace ~/.openclaw/workspace openclaw setup --import-from hermes --import-source ~/.hermes openclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token ``` ## 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](/vi/cli/migrate) để 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 * [Tài liệu tham khảo CLI](/vi/cli) * [Thiết lập ban đầu](/vi/cli/onboard) * [Thiết lập ban đầu (CLI)](/vi/start/wizard) * [Bắt đầu](/vi/start/getting-started) * [Tổng quan cài đặt](/vi/install)