OpenClawDocs
Trên trang này

Trên trang này

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Setup guides and reference

Tự động hóa CLI

Sử dụng openclaw onboard --non-interactive để thiết lập bằng tập lệnh. Lệnh này yêu cầu --accept-risk: quá trình thiết lập không tương tác có thể ghi thông tin xác thực và cấu hình daemon mà không có lời nhắc xác nhận, vì vậy cờ này thể hiện việc xác nhận rủi ro một cách rõ ràng.

Ví dụ không tương tác cơ bản

bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --secret-input-mode plaintext \  --gateway-bind loopback \  --install-daemon \  --daemon-runtime node \  --skip-bootstrap \  --skip-skills

Thêm --json để nhận bản tóm tắt mà máy có thể đọc được.

  • --gateway-port mặc định là 18789; chỉ truyền cờ này khi cần ghi đè.
  • --skip-bootstrap bỏ qua việc tạo các tệp không gian làm việc mặc định, dành cho quy trình tự động hóa đã điền sẵn không gian làm việc riêng.
  • --secret-input-mode ref lưu một tham chiếu dựa trên biến môi trường ({ source: "env", provider: "default", id: "<ENV_VAR>" }) trong hồ sơ xác thực thay vì khóa dạng văn bản thuần. Ở chế độ ref không tương tác, biến môi trường của nhà cung cấp phải được thiết lập sẵn trong môi trường tiến trình: việc truyền cờ khóa nội tuyến mà không có biến môi trường tương ứng sẽ thất bại ngay lập tức.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Ví dụ dành riêng cho từng nhà cung cấp

Ví dụ về khóa API Anthropic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Ví dụ về Cloudflare AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice cloudflare-ai-gateway-api-key \  --cloudflare-ai-gateway-account-id "your-account-id" \  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \  --gateway-bind loopback
Ví dụ về Gemini
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Ví dụ về Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Ví dụ về Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Ví dụ về Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
Ví dụ về OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

Chuyển sang --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" để sử dụng danh mục Go.

Ví dụ về Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Ví dụ về Vercel AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \  --gateway-bind loopback
Ví dụ về Z.AI
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
Ví dụ về nhà cung cấp tùy chỉnh
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --custom-provider-id "my-custom" \  --custom-compatibility anthropic \  --custom-image-input \  --gateway-bind loopback

--custom-api-key là tùy chọn; một số điểm cuối không yêu cầu xác thực. Nếu bỏ qua, quá trình thiết lập ban đầu sẽ kiểm tra CUSTOM_API_KEY trong môi trường. --custom-provider-id là tùy chọn và được tự động suy ra từ URL cơ sở khi bị bỏ qua. --custom-compatibility mặc định là openai (các giá trị khác: openai-responses, anthropic).

OpenClaw suy luận khả năng hỗ trợ đầu vào hình ảnh từ các mẫu mã định danh mô hình thị giác đã biết (gpt-4o, claude-3/4, gemini, các hậu tố -vl/vision và những mẫu tương tự). Thêm --custom-image-input để buộc bật tính năng này cho một mô hình thị giác chưa được nhận diện, hoặc --custom-text-input để buộc chỉ sử dụng văn bản.

Biến thể chế độ tham chiếu, lưu apiKey dưới dạng { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:

bash
export CUSTOM_API_KEY="your-key"openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --secret-input-mode ref \  --custom-provider-id "my-custom" \  --custom-compatibility anthropic \  --custom-image-input \  --gateway-bind loopback

Xác thực bằng mã thông báo thiết lập Anthropic vẫn được hỗ trợ, nhưng OpenClaw ưu tiên tái sử dụng Claude CLI khi có phiên đăng nhập Claude CLI cục bộ. Đối với môi trường sản xuất, nên ưu tiên khóa API Anthropic.

Thêm một tác tử khác

openclaw agents add <name> tạo một tác tử riêng biệt với không gian làm việc, phiên và hồ sơ xác thực riêng. Chạy lệnh mà không có --workspace (và không có cờ nào khác) sẽ khởi chạy trình hướng dẫn tương tác; việc truyền bất kỳ cờ nào trong số --workspace, --model, --agent-dir, --bind hoặc --non-interactive sẽ chạy lệnh ở chế độ không tương tác và khi đó yêu cầu phải có --workspace.

bash
openclaw agents add work \  --workspace ~/.openclaw/workspace-work \  --model openai/gpt-5.6-sol \  --bind whatsapp:biz \  --non-interactive \  --json

Các khóa cấu hình mà lệnh ghi (mục nhập agents.list[] cho mã định danh tác tử mới):

  • name
  • workspace
  • agentDir
  • model (chỉ khi truyền --model)

Lưu ý:

  • Không gian làm việc mặc định (khi bỏ qua --workspace trong trình hướng dẫn tương tác): ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> có thể được lặp lại; thêm các liên kết để định tuyến tin nhắn đến cho tác tử mới (trình hướng dẫn cũng có thể thực hiện việc này theo cách tương tác).
  • Tên tác tử được chuẩn hóa thành một mã định danh tác tử hợp lệ; main được dành riêng.

Tài liệu liên quan

Was this useful?