> ## 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 ban đầu # `openclaw onboard` Thiết lập có hướng dẫn ưu tiên thiết lập suy luận trước: quy trình này phát hiện quyền truy cập AI hiện có, yêu cầu một lượt hoàn thành trực tiếp, chỉ lưu tuyến hoạt động, rồi khởi động OpenClaw để cấu hình phần còn lại. `openclaw setup` truy cập luồng này trên hệ thống mới hoặc bất cứ khi nào có tùy chọn nhập môn; các hệ thống đã cấu hình sử dụng `openclaw setup` thuần túy để trò chuyện với tác tử hệ thống. `openclaw setup --baseline` chỉ ghi cấu hình/không gian làm việc cơ sở. Hướng dẫn từng bước về luồng CLI tương tác. Cách các phần trong quy trình nhập môn OpenClaw phối hợp với nhau. Đầu ra, cơ chế nội bộ và hành vi của từng bước. Các cờ không tương tác và thiết lập bằng tập lệnh. Luồng nhập môn cho ứng dụng thanh menu macOS. ## Ví dụ ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard openclaw onboard --tui openclaw onboard --classic openclaw onboard --modern openclaw onboard --flow quickstart openclaw onboard --flow manual openclaw onboard --flow import openclaw onboard --import-from hermes --import-source ~/.hermes openclaw onboard --skip-bootstrap openclaw onboard recommendations --json openclaw onboard recommendations acknowledge openclaw onboard recommendations acknowledge --retry "" openclaw onboard recommendations refresh openclaw onboard --mode remote --remote-url wss://gateway-host:18789 ``` `openclaw onboard recommendations` đọc các kết quả khớp đề xuất ứng dụng đang chờ xử lý được lưu trong quá trình nhập môn. Thêm `--json` để nhận danh sách máy có thể đọc được dùng cho quá trình khởi tạo lần chạy đầu tiên. Lệnh này không quét lại các ứng dụng đã cài đặt hoặc gọi mô hình. Đầu ra chỉ chứa các ID cài đặt đã xác thực, nguồn và cấp; quy trình này cố ý bỏ qua nội dung không đáng tin cậy từ marketplace, lý do của mô hình và nhãn ứng dụng cục bộ. Sau khi đề nghị đề xuất đã được trả lời, lệnh trả về danh sách trống và các lần nhập môn sau sẽ bỏ qua hoàn toàn bước này. `openclaw onboard recommendations refresh` xóa đề nghị đã lưu để lần nhập môn tiếp theo quét lại các ứng dụng đã cài đặt và tạo đề nghị mới. Không gian làm việc mới hoãn lựa chọn đề xuất đến cuộc trò chuyện khởi tạo. Sau khi cuộc trò chuyện đó xử lý lựa chọn của người dùng, `openclaw onboard recommendations acknowledge` đánh dấu đề nghị đã lưu là đã được trả lời. Thao tác xác nhận có tính lũy đẳng. Nếu một cài đặt đã chọn thất bại, hãy truyền từng ID mờ bị lỗi bằng `--retry `; các kết quả khớp thành công và bị từ chối sẽ được sử dụng, trong khi các kết quả khớp thất bại vẫn ở trạng thái chờ xử lý cho lần nhập môn sau. ID không xác định sẽ gây lỗi mà không thay đổi đề nghị đã lưu. Sau khi quá trình cài đặt skill ClawHub bị gián đoạn, mục tiêu hiện có chỉ được tính là thành công khi `openclaw skills verify "@owner/slug"` thành công với cùng ID đề xuất có tên nhà phát hành và đầu ra JSON của lệnh báo cáo `openclaw.resolution.source: "installed"`. Chỉ xác minh registry không phải là bằng chứng về cài đặt cục bộ. Nếu không, hãy giữ ID đó ở trạng thái chờ xử lý bằng `--retry` và không ghi đè skill hiện có. * `--classic`: mở trình hướng dẫn đầy đủ từng bước. Không thể kết hợp với `--non-interactive`; bỏ qua `--classic` để thiết lập tự động. * `--flow quickstart`: mở trình hướng dẫn cổ điển với số lời nhắc tối thiểu và tự động tạo token Gateway. * `--flow manual` (bí danh `advanced`): mở trình hướng dẫn cổ điển với đầy đủ lời nhắc về cổng, liên kết và xác thực. * `--flow import`: chạy nhà cung cấp di chuyển được phát hiện (ví dụ Hermes qua `--import-from hermes`), xem trước kế hoạch, rồi áp dụng sau khi xác nhận. Khi thao tác nhập tương tác cung cấp mô hình mặc định, quy trình nhập môn yêu cầu tuyến đó vượt qua một lượt hoàn thành trực tiếp trước khi bỏ qua thiết lập nhà cung cấp; tuyến được nhập thất bại sẽ quay lại cấu hình nhà cung cấp. Chỉ nhập vào một thiết lập OpenClaw mới — trước tiên hãy đặt lại cấu hình, thông tin xác thực, phiên và trạng thái không gian làm việc nếu có. Sử dụng [`openclaw migrate`](/vi/cli/migrate) để xem kế hoạch chạy thử, chế độ ghi đè, báo cáo và ánh xạ chính xác. * `--remote-url` và `--remote-token`: điền sẵn bước Gateway từ xa cổ điển và ghi đè các giá trị từ xa đã lưu cho lần chạy nà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 trong lời nhắc và tuân theo lựa chọn lưu trữ văn bản thuần hoặc SecretRef hiện có của trình hướng dẫn. * `--tailscale-reset-on-exit` và `--no-tailscale-reset-on-exit`: kiểm soát rõ ràng việc có đặt lại cấu hình Tailscale Serve hoặc Funnel khi Gateway thoát hay không. Việc bỏ qua cả hai sẽ giữ nguyên cài đặt hiện tại trong các lần chạy lại không tương tác. * `--modern` là bí danh tương thích cho trợ lý thiết lập hội thoại OpenClaw. Nó sử dụng cùng cổng suy luận trực tiếp như `openclaw setup` và chỉ chấp nhận `--workspace`, `--accept-risk`, `--non-interactive` và `--json`. Các cờ thiết lập khác sẽ bị từ chối thay vì bị âm thầm bỏ qua. ## Luồng có hướng dẫn `openclaw onboard` thuần túy khởi động luồng có hướng dẫn. Quy trình hiển thị thông báo bảo mật, rồi đặt trước một câu hỏi: **toàn quyền truy cập** (khuyến nghị — thiết lập tự động tìm ứng dụng AI, khóa và runtime cục bộ) hoặc **hỏi trước** (thiết lập hỏi một lần trước khi tìm kiếm hoặc cho phép bạn cấu hình thủ công). Lựa chọn này được lưu dưới dạng `wizard.accessMode`. Khi cho phép khám phá, quy trình nhập môn phát hiện quyền truy cập AI đã có thông qua các mô hình đã cấu hình, biến môi trường khóa API và các CLI cục bộ được hỗ trợ, rồi kiểm tra ứng viên được đề xuất bằng một lượt hoàn thành thực. Nếu một ứng viên thất bại, quy trình nhập môn âm thầm thử ứng viên khả dụng tiếp theo và tóm tắt mọi ứng viên không phản hồi trong một dòng; tuyến hoạt động được thông báo cùng tùy chọn một phím để xem tất cả các tuyến khác. Nếu quá trình phát hiện tự động không còn ứng viên, trình chọn nhà cung cấp hiển thị OpenAI, Anthropic, xAI (Grok), Google và OpenRouter trước tiên. Chọn **Thêm…** để xem mọi nhà cung cấp được hỗ trợ khác, được nhóm theo nhà cung cấp; khu vực, gói và phương thức xác thực sau đó xuất hiện trong menu thứ hai. Các phương thức đăng nhập qua trình duyệt hoặc thiết bị được hỗ trợ và khóa API hoặc token được che đều sử dụng cùng đường dẫn hoàn thành trực tiếp. OpenClaw chỉ lưu tuyến mô hình đã xác minh cùng thông tin xác thực của tuyến sau khi kiểm tra thành công; ứng viên thất bại không thay thế mô hình đã cấu hình hoặc lưu thông tin xác thực đã thử. Chọn **Bỏ qua lúc này** để thoát mà không khởi động OpenClaw và chạy lại `openclaw onboard` khi bạn sẵn sàng. Thiết lập không gian làm việc và Gateway vẫn không thay đổi cho đến khi OpenClaw khởi động. Trong chế độ có hướng dẫn, `--workspace ` cung cấp không gian làm việc do OpenClaw đề xuất và ngữ cảnh suy luận biệt lập. Giá trị này không được lưu cho đến khi bạn phê duyệt đề xuất thiết lập OpenClaw. Quy trình nhập môn cổ điển và không tương tác lưu không gian làm việc qua luồng thiết lập thông thường. Khi chạy lại với danh sách tác tử hiện có, quy trình nhập môn giữ nguyên không gian làm việc của đội đã cấu hình: trình hướng dẫn cổ điển hiển thị cả hai đường dẫn và yêu cầu xác nhận rõ ràng trước khi di chuyển, còn thiết lập không tương tác sẽ cảnh báo và giữ nguyên giá trị hiện tại. Sau khi suy luận vượt qua kiểm tra, quy trình nhập môn kiểm tra bộ nhớ từ các công cụ AI cục bộ đượ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, một trang đề nghị sao chép chúng vào không gian làm việc của tác tử trong `memory/imports/` để truy hồi theo chỉ mục. Không có gì được nhập nếu chưa xác nhận, các tệp đã nhập trước đó sẽ được bỏ qua và bạn luôn có thể nhập sau từ [trang nhập bộ nhớ](/vi/web/control-ui) trong Control UI, nơi cung cấp cùng phạm vi chỉ dành cho bộ nhớ. (Một lần chạy [`openclaw migrate`](/vi/cli/migrate) đầy đủ có phạm vi rộng hơn: cũng có thể nhập cấu hình, skill và thông tin xác thực.) Trình hướng dẫn cổ điển hiển thị cùng trang sau khi chuẩn bị không gian làm việc. Sau khi suy luận vượt qua kiểm tra (và đề nghị nhập bộ nhớ), quy trình nhập môn có hướng dẫn tự động áp dụng thiết lập tiêu chuẩn — không gian làm việc, Gateway và phiên, cùng kế hoạch mà cuộc trò chuyện `openclaw setup` dạng hội thoại sẽ áp dụng khi trả lời "có" — sau đó đề xuất plugin và skill dựa trên các ứng dụng đã cài đặt; tên ứng dụng được đối sánh thông qua mô hình đã cấu hình và tìm kiếm ClawHub, và bước này có thể được tắt bằng [`wizard.appRecommendations`](/vi/gateway/configuration-reference#wizard). Trong phiên máy tính để bàn macOS, Linux hoặc Windows, quy trình sau đó mở bảng điều khiển Control UI đã xác thực và chờ tối đa 60 giây để máy khách trình duyệt kết nối. Trên Linux không có giao diện đồ họa hoặc qua SSH, quy trình in một URL bảng điều khiển nổi bật có thể sao chép-dán, bao gồm lệnh chuyển tiếp cổng SSH cho Gateway loopback, rồi chờ tối đa năm phút. Kết nối thành công sẽ tiếp tục trong trình duyệt; Gateway không thể truy cập hoặc hết thời gian chờ sẽ quay về cùng lối thoát trong terminal như trước. Truyền `--tui` để bỏ qua việc chuyển giao sang trình duyệt và buộc dùng lối thoát terminal đó. Nếu áp dụng thiết lập thất bại, quy trình nhập môn quay về cuộc trò chuyện OpenClaw dạng hội thoại để hoàn tất theo cách tương tác. Kênh, tác tử, plugin và các tính năng tùy chọn khác vẫn thuộc phạm vi trò chuyện OpenClaw: chạy `openclaw` và dùng `open channel wizard for ` để chuyển việc thu thập thông tin xác thực của kênh sang trình hướng dẫn terminal có che dữ liệu. Để thay đổi nhà cung cấp mô hình hoặc phương thức xác thực của nhà cung cấp, hãy thoát OpenClaw và chạy `openclaw onboard`; OpenClaw không mở các luồng nhà cung cấp có hướng dẫn hoặc cổ điển. Trên bản cài đặt đã cấu hình, việc chạy lại `openclaw onboard` trước tiên xác minh mô hình mặc định hiện tại, vì vậy cùng luồng này hoạt động như một lượt xác minh và sửa chữa — không áp dụng lại thiết lập, cài đặt lại hoặc khởi động lại dịch vụ Gateway. Nếu kiểm tra đó thất bại, mô hình đã cấu hình không bao giờ bị tự động thay thế — quy trình nhập môn dừng lại và hỏi cách tiếp tục. Kiểm tra chạy bên ngoài không gian làm việc của bạn, vì vậy mô hình do plugin không gian làm việc cung cấp có thể thất bại tại đây nhưng vẫn hoạt động trong tác tử. Sử dụng `openclaw onboard --classic` cho xác thực dành riêng cho nhà cung cấp, kênh, skill, thiết lập Gateway từ xa, nhập dữ liệu hoặc toàn bộ điều khiển Gateway. Để thiết lập và sửa chữa không liên quan đến suy luận theo kiểu hội thoại, hãy chạy `openclaw setup`; `openclaw onboard --modern` là bí danh tương thích qua cùng cổng suy luận. Trình hướng dẫn cổ điển có thể tùy chọn xác minh mô hình mặc định bằng một lượt hoàn thành trực tiếp, nhưng OpenClaw sẽ không khởi động cho đến khi lượt kiểm tra suy luận trực tiếp của chính nó thành công. Trong terminal tương tác, `openclaw` thuần túy (không có lệnh con) định tuyến theo trạng thái cấu hình: * Nếu tệp cấu hình đang hoạt động bị thiếu hoặc không có cài đặt do người dùng tạo (trống hoặc chỉ có siêu dữ liệu), quy trình sẽ bắt đầu nhập môn có hướng dẫn. * Nếu tệp cấu hình tồn tại nhưng không vượt qua xác thực, quy trình sẽ bắt đầu đường dẫn nhập môn cổ điển với hướng dẫn `openclaw doctor`. OpenClaw cần khả năng suy luận hoạt động và không được dùng để sửa chữa trạng thái trước suy luận này. * Nếu tệp cấu hình hợp lệ, quy trình sẽ mở TUI tác tử thông thường. Một Gateway đã cấu hình có thể truy cập với tác tử và mô hình sẽ đi thẳng đến giao diện đó mà không qua nhập môn hoặc OpenClaw. Trên bản cài đặt đã cấu hình, truy cập OpenClaw bằng `/openclaw` trong TUI hoặc `openclaw setup`. `ws://` dạng văn bản thuần được chấp nhận cho loopback, địa chỉ IP riêng dạng literal, `.local` và URL Gateway `*.ts.net` của Tailnet. Đối với các tên DNS riêng đáng tin cậy khác, hãy đặt `OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` trong môi trường quy trình nhập môn. ## Đặt lại ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --reset openclaw onboard --reset --reset-scope full ``` `--reset` xóa trạng thái trước khi chạy thiết lập. `--reset-scope` kiểm soát phạm vi: `config` (chỉ cấu hình), `config+creds+sessions` (mặc định khi truyền `--reset` mà không có phạm vi) hoặc `full` (cũng đặt lại không gian làm việc). Việc đặt lại không gian làm việc chỉ xảy ra với `--reset-scope full`. ## Ngôn ngữ Quy trình nhập môn tương tác sử dụng ngôn ngữ của trình hướng dẫn CLI cho nội dung thiết lập cố định. Quy trình dùng giá trị không trống đầu tiên theo thứ tự sau: 1. `OPENCLAW_LOCALE` 2. `LC_ALL` 3. `LC_MESSAGES` 4. `LANG` 5. Phương án dự phòng tiếng Anh Các ngôn ngữ được trình hướng dẫn hỗ trợ là `en`, `zh-CN` và `zh-TW`. Giá trị ngôn ngữ có thể sử dụng dạng dấu gạch dưới hoặc hậu tố POSIX, chẳng hạn như `zh_CN.UTF-8`. Tên sản phẩm, tên lệnh, khóa cấu hình, URL, ID nhà cung cấp, ID mô hình và nhãn plugin/kênh được giữ nguyên. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} OPENCLAW_LOCALE=zh-CN openclaw onboard OPENCLAW_LOCALE=en openclaw onboard # Ghi đè rõ ràng bằng tiếng Anh ``` ## Thiết lập không tương tác `--non-interactive` yêu cầu `--accept-risk` (xác nhận rằng các tác nhân rất mạnh và quyền truy cập toàn bộ hệ thống tiềm ẩn rủi ro). `--mode` mặc định là `local`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice custom-api-key \ --custom-base-url "https://llm.example.com/v1" \ --custom-model-id "foo-large" \ --custom-api-key "$CUSTOM_API_KEY" \ --secret-input-mode plaintext \ --custom-compatibility openai \ --custom-image-input ``` `--custom-api-key` là tùy chọn; nếu bị bỏ qua, quá trình khởi tạo sẽ kiểm tra `CUSTOM_API_KEY` trong môi trường. OpenClaw tự động đánh dấu các ID mô hình thị giác phổ biến (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral và các mô hình tương tự) là có khả năng xử lý hình ảnh. Truyền `--custom-image-input` cho các ID mô hình thị giác tùy chỉnh chưa xác định, hoặc `--custom-text-input` để buộc siêu dữ liệu chỉ hỗ trợ văn bản. Sử dụng `--custom-compatibility openai-responses` cho các điểm cuối tương thích với OpenAI có hỗ trợ `/v1/responses` nhưng không hỗ trợ `/v1/chat/completions`; các giá trị hợp lệ là `openai` (mặc định), `openai-responses`, `anthropic`. LM Studio cũng có một cờ khóa dành riêng cho nhà cung cấp: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice lmstudio \ --custom-base-url "http://localhost:1234/v1" \ --custom-model-id "qwen/qwen3.5-9b" \ --lmstudio-api-key "$LM_API_TOKEN" \ --accept-risk ``` Ollama không tương tác: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice ollama \ --custom-base-url "http://ollama-host:11434" \ --custom-model-id "qwen3.5:27b" \ --accept-risk ``` `--custom-base-url` mặc định là `http://127.0.0.1:11434`. `--custom-model-id` là tùy chọn; nếu bị bỏ qua, quá trình khởi tạo sử dụng các giá trị mặc định do Ollama đề xuất. Các ID mô hình đám mây như `kimi-k2.5:cloud` cũng hoạt động tại đây. Lưu khóa nhà cung cấp dưới dạng tham chiếu thay vì văn bản thuần túy: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice openai-api-key \ --secret-input-mode ref \ --accept-risk ``` Với `--secret-input-mode ref`, quá trình khởi tạo ghi các tham chiếu dựa trên biến môi trường thay vì giá trị khóa dạng văn bản thuần túy: đối với các nhà cung cấp dựa trên hồ sơ xác thực, thao tác này ghi `keyRef: { source: "env", provider: "default", id: }`; đối với các nhà cung cấp tùy chỉnh, thao tác này ghi `models.providers..apiKey` theo cùng cách (ví dụ: `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`). Quy ước: đặt biến môi trường của nhà cung cấp trong môi trường tiến trình khởi tạo (ví dụ: `OPENAI_API_KEY`) và không đồng thời truyền cờ khóa nội tuyến trừ khi biến môi trường đó đã được đặt — giá trị cờ không có biến môi trường tương ứng sẽ khiến tiến trình dừng ngay và cung cấp hướng dẫn. ### Xác thực Gateway (không tương tác) * `--gateway-auth token --gateway-token ` lưu một token dạng văn bản thuần túy. `token` là chế độ xác thực mặc định. * `--gateway-auth token --gateway-token-ref-env ` lưu `gateway.auth.token` dưới dạng SecretRef từ biến môi trường. Yêu cầu một biến môi trường không rỗng có tên đó trong môi trường tiến trình khởi tạo. * `--gateway-token` và `--gateway-token-ref-env` loại trừ lẫn nhau. * Với `--install-daemon`: `gateway.auth.token` do SecretRef quản lý được xác thực nhưng không được lưu dưới dạng văn bản thuần túy đã phân giải trong siêu dữ liệu môi trường dịch vụ giám sát; nếu không thể phân giải tham chiếu, quá trình cài đặt sẽ từ chối tiếp tục và cung cấp hướng dẫn khắc phục. Nếu cả `gateway.auth.token` và `gateway.auth.password` đều được cấu hình còn `gateway.auth.mode` chưa được đặt, quá trình cài đặt sẽ bị chặn cho đến khi chế độ được đặt rõ ràng. * Quá trình khởi tạo cục bộ ghi `gateway.mode="local"` vào cấu hình. Nếu tệp cấu hình sau đó thiếu `gateway.mode`, điều này cho thấy cấu hình bị hỏng hoặc chỉnh sửa thủ công chưa hoàn tất, chứ không phải một lối tắt hợp lệ cho chế độ cục bộ. * Quá trình khởi tạo cục bộ cài đặt các plugin có thể tải xuống mà đường dẫn thiết lập đã chọn yêu cầu (ví dụ: plugin môi trường thực thi Codex hoặc Copilot cho các lựa chọn xác thực đó). Quá trình khởi tạo từ xa chỉ ghi thông tin kết nối cho Gateway từ xa — quá trình này không bao giờ cài đặt các gói plugin cục bộ. * `--allow-unconfigured` là một cơ chế thoát riêng biệt cho `openclaw gateway run`; cơ chế này không cho phép quá trình khởi tạo bỏ qua `gateway.mode`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export OPENAI_API_KEY="your-provider-key" export OPENCLAW_GATEWAY_TOKEN="your-token" openclaw onboard --non-interactive \ --mode local \ --auth-choice openai-api-key \ --secret-input-mode ref \ --gateway-auth token \ --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \ --accept-risk ``` ### Tình trạng Gateway cục bộ * Trừ khi bạn truyền `--skip-health`, quá trình khởi tạo sẽ chờ đến khi có thể kết nối với Gateway cục bộ trước khi thoát thành công. * `--install-daemon` khởi động đường dẫn cài đặt Gateway được quản lý trước tiên. Nếu không có cờ này, một Gateway cục bộ phải đang chạy sẵn (ví dụ: `openclaw gateway run`). * `--skip-health` bỏ qua bước chờ nếu bạn chỉ muốn tự động hóa việc ghi cấu hình/không gian làm việc/dữ liệu khởi tạo. * `--skip-bootstrap` đặt `agents.defaults.skipBootstrap: true` và bỏ qua việc tạo `AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md` và `BOOTSTRAP.md`. * Trên Windows gốc, `--install-daemon` thử Scheduled Tasks trước và chuyển sang mục đăng nhập theo người dùng trong thư mục Startup nếu việc tạo tác vụ bị từ chối. ### Chế độ tham chiếu tương tác * Chọn **Sử dụng tham chiếu bí mật** khi được nhắc, sau đó chọn **Biến môi trường** hoặc một nhà cung cấp bí mật đã cấu hình (`file` hoặc `exec`). * Quá trình khởi tạo thực hiện xác thực sơ bộ nhanh trước khi lưu tham chiếu và cho phép bạn thử lại khi thất bại. ### Lựa chọn điểm cuối Z.AI `--auth-choice zai-api-key` tự động phát hiện điểm cuối và mô hình Z.AI phù hợp nhất cho khóa của bạn: các điểm cuối Coding Plan ưu tiên `zai/glm-5.2` (chuyển sang `glm-5.1` nếu không khả dụng); các điểm cuối API chung mặc định là `zai/glm-5.1`. Để buộc sử dụng một điểm cuối Coding Plan, hãy chọn trực tiếp `zai-coding-global` hoặc `zai-coding-cn`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Chọn điểm cuối không cần lời nhắc openclaw onboard --non-interactive \ --auth-choice zai-coding-global \ --zai-api-key "$ZAI_API_KEY" # Các lựa chọn điểm cuối Z.AI khác: zai-coding-cn, zai-global, zai-cn ``` Mistral: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --non-interactive \ --auth-choice mistral-api-key \ --mistral-api-key "$MISTRAL_API_KEY" ``` ## Các cờ không tương tác bổ sung Xác thực mô hình dựa trên token (dùng với `--auth-choice token`): | Cờ | Mô tả | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--token-provider ` | ID nhà cung cấp token phát hành token | | `--token ` | Giá trị token để xác thực mô hình | | `--token-profile-id ` | ID hồ sơ xác thực (mặc định `:manual`; một số luồng do nhà cung cấp sở hữu sử dụng giá trị mặc định riêng, chẳng hạn như `anthropic:default`) | | `--token-expires-in ` | Thời hạn hết hiệu lực tùy chọn của token (ví dụ: `365d`, `12h`) | Cloudflare AI Gateway: `--cloudflare-ai-gateway-account-id `, `--cloudflare-ai-gateway-gateway-id `. Điều khiển cài đặt daemon: `--no-install-daemon` / `--skip-daemon` (bí danh; bỏ qua cài đặt dịch vụ Gateway), `--daemon-runtime `. Skills: `--node-manager ` (mặc định `npm`), `--skip-skills`. Thiết lập giao diện người dùng và hook: `--skip-ui` (bỏ qua lời nhắc Control UI/TUI), `--skip-hooks` (bỏ qua thiết lập webhook/hook), `--skip-channels`, `--skip-search`. Đầu ra: `--suppress-gateway-token-output` ẩn đầu ra Gateway/giao diện người dùng có chứa token (gợi ý token, URL tự động đăng nhập có nhúng token và tự động khởi chạy Control UI) — hữu ích trong các thiết bị đầu cuối dùng chung và CI. `--json` không mặc nhiên kích hoạt chế độ không tương tác trong quá trình khởi tạo có hướng dẫn hoặc cổ điển. Với `--modern`, JSON là một bản tổng quan OpenClaw dùng một lần và tiến trình sẽ thoát sau kết quả duy nhất đó. Sử dụng `--non-interactive` cho các tập lệnh khác. ## Lọc trước nhà cung cấp Khi một lựa chọn xác thực ngụ ý một nhà cung cấp ưu tiên, quá trình khởi tạo sẽ lọc trước các bộ chọn mô hình mặc định và danh sách cho phép để chỉ hiển thị các mô hình của nhà cung cấp đó. Bộ lọc cũng khớp với các nhà cung cấp khác thuộc cùng một plugin, bao gồm các biến thể Coding Plan như `volcengine`/`volcengine-plan` và `byteplus`/`byteplus-plan`. Nếu bộ lọc nhà cung cấp ưu tiên không trả về mô hình nào đã tải, quá trình khởi tạo sẽ chuyển sang danh mục chưa lọc thay vì để bộ chọn trống. ## Các lời nhắc tiếp theo về tìm kiếm web Một số nhà cung cấp dịch vụ tìm kiếm web kích hoạt lời nhắc tiếp theo dành riêng cho nhà cung cấp trong quá trình khởi tạo: * **Grok** có thể cung cấp thiết lập `x_search` tùy chọn với cùng thông tin xác thực xAI và lựa chọn mô hình `x_search`. * **Kimi** có thể yêu cầu vùng API Moonshot (`api.moonshot.ai` so với `api.moonshot.cn`) và mô hình tìm kiếm web Kimi mặc định. ## Các hành vi khác * Hành vi phạm vi tin nhắn trực tiếp của quá trình khởi tạo cục bộ: [Tài liệu tham khảo thiết lập CLI](/vi/start/wizard-cli-reference#outputs-and-internals). * Cách bắt đầu cuộc trò chuyện đầu tiên nhanh nhất: `openclaw dashboard` (Control UI, không thiết lập kênh). * Nhà cung cấp tùy chỉnh: kết nối bất kỳ điểm cuối nào tương thích với OpenAI hoặc Anthropic, bao gồm các nhà cung cấp được lưu trữ nhưng không có trong danh sách. Sử dụng khả năng tương thích **Không xác định** để tự động phát hiện thông qua một phép thăm dò trực tiếp. * Nếu phát hiện trạng thái Hermes, quá trình khởi tạo sẽ cung cấp một luồng di chuyển (xem `--flow import` ở trên). ## Các lệnh thường dùng tiếp theo Sau này, sử dụng `openclaw configure` cho các thay đổi có mục tiêu không liên quan đến suy luận và `openclaw channels add` để chỉ thiết lập kênh. Đối với thay đổi nhà cung cấp mô hình hoặc tuyến xác thực, hãy chạy `openclaw onboard` thay thế. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw channels add openclaw configure openclaw agents add ```