​

Tham khảo Thiết lập CLI

​

Những gì wizard thực hiện

• Thiết lập mô hình và xác thực (OpenAI Code subscription OAuth, khóa API Anthropic hoặc token thiết lập, cùng với các tùy chọn MiniMax, GLM, Ollama, Moonshot và AI Gateway)
• Vị trí Workspace và các file khởi động
• Cài đặt Gateway (cổng, bind, xác thực, tailscale)
• Kênh và nhà cung cấp (Telegram, WhatsApp, Discord, Google Chat, plugin Mattermost, Signal)
• Cài đặt Daemon (LaunchAgent hoặc systemd user unit)
• Kiểm tra sức khỏe
• Thiết lập kỹ năng

​

Chi tiết quy trình cục bộ

​

Chi tiết chế độ từ xa

• URL gateway từ xa (ws://...)
• Token nếu yêu cầu xác thực gateway từ xa (khuyến nghị)

​

Tùy chọn xác thực và mô hình

• Chọn mô hình mặc định từ các tùy chọn được phát hiện, hoặc nhập nhà cung cấp và mô hình thủ công.
• Wizard chạy kiểm tra mô hình và cảnh báo nếu mô hình được cấu hình không xác định hoặc thiếu xác thực.

• Thông tin xác thực OAuth: ~/.openclaw/credentials/oauth.json
• Hồ sơ xác thực (khóa API + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• Hành vi onboarding mặc định lưu trữ khóa API dưới dạng giá trị văn bản trong hồ sơ xác thực.
• --secret-input-mode ref kích hoạt chế độ tham chiếu thay vì lưu trữ khóa dạng văn bản. Trong thiết lập tương tác, bạn có thể chọn:
  • tham chiếu biến môi trường (ví dụ keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • tham chiếu nhà cung cấp đã cấu hình (file hoặc exec) với bí danh nhà cung cấp + id
• Chế độ tham chiếu tương tác chạy xác thực trước chuyến bay nhanh trước khi lưu.
  • Tham chiếu biến môi trường: xác thực tên biến + giá trị không rỗng trong môi trường onboarding hiện tại.
  • Tham chiếu nhà cung cấp: xác thực cấu hình nhà cung cấp và giải quyết id yêu cầu.
  • Nếu xác thực trước chuyến bay thất bại, onboarding hiển thị lỗi và cho phép bạn thử lại.
• Trong chế độ không tương tác, --secret-input-mode ref chỉ hỗ trợ biến môi trường.
  • Đặt biến môi trường nhà cung cấp trong môi trường quy trình onboarding.
  • Cờ khóa nội tuyến (ví dụ --openai-api-key) yêu cầu biến môi trường đó được đặt; nếu không onboarding sẽ thất bại nhanh chóng.
  • Đối với nhà cung cấp tùy chỉnh, chế độ ref không tương tác lưu trữ models.providers.<id>.apiKey dưới dạng { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
  • Trong trường hợp nhà cung cấp tùy chỉnh đó, --custom-api-key yêu cầu CUSTOM_API_KEY được đặt; nếu không onboarding sẽ thất bại nhanh chóng.
• Thông tin xác thực xác thực Gateway hỗ trợ các lựa chọn văn bản và SecretRef trong thiết lập tương tác:
  • Chế độ token: Tạo/lưu trữ token dạng văn bản (mặc định) hoặc Sử dụng SecretRef.
  • Chế độ mật khẩu: văn bản hoặc SecretRef.
• Đường dẫn SecretRef token không tương tác: --gateway-token-ref-env <ENV_VAR>.
• Các thiết lập văn bản hiện có vẫn hoạt động không thay đổi.

​

Đầu ra và nội bộ

• agents.defaults.workspace
• agents.defaults.model / models.providers (nếu chọn Minimax)
• tools.profile (onboarding cục bộ mặc định là "coding" khi chưa được đặt; các giá trị rõ ràng hiện có được giữ nguyên)
• gateway.* (chế độ, bind, xác thực, tailscale)
• session.dmScope (onboarding cục bộ mặc định là per-channel-peer khi chưa được đặt; các giá trị rõ ràng hiện có được giữ nguyên)
• channels.telegram.botToken, channels.discord.token, channels.signal.*, channels.imessage.*
• Danh sách cho phép kênh (Slack, Discord, Matrix, Microsoft Teams) khi bạn chọn tham gia trong các lời nhắc (tên được giải quyết thành ID khi có thể)
• skills.install.nodeManager
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode

• wizard.start
• wizard.next
• wizard.cancel
• wizard.status

• Tải xuống tài sản phát hành phù hợp
• Lưu trữ dưới ~/.openclaw/tools/signal-cli/<version>/
• Ghi channels.signal.cliPath trong cấu hình
• Các bản dựng JVM yêu cầu Java 21
• Các bản dựng gốc được sử dụng khi có sẵn
• Windows sử dụng WSL2 và theo luồng signal-cli Linux bên trong WSL

​

Tài liệu liên quan

• Trung tâm Onboarding: Onboarding (CLI)
• Tự động hóa và script: Tự động hóa CLI
• Tham khảo lệnh: openclaw onboard