Chuyển đến nội dung chính
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.
--json không mặc nhiên bật chế độ không tương tác. Hãy truyền rõ ràng --non-interactive --accept-risk cho các tập lệnh.

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

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.

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

Chuyển sang --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" để sử dụng danh mục Go.
--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" }:
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.
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