First steps
Bắt đầu
Cài đặt OpenClaw, chạy quy trình thiết lập ban đầu và trò chuyện với trợ lý AI của bạn — tất cả chỉ trong khoảng 5 phút. Khi hoàn tất, bạn sẽ có một Gateway đang chạy, xác thực đã được cấu hình, và một phiên trò chuyện hoạt động.
Bạn cần có
- Node.js — khuyến nghị Node 24 (cũng hỗ trợ Node 22.16+)
- Khóa API từ một nhà cung cấp mô hình (Anthropic, OpenAI, Google, v.v.) — quy trình thiết lập ban đầu sẽ yêu cầu bạn nhập
Thiết lập nhanh
Cài đặt OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexChạy quy trình thiết lập ban đầu
openclaw onboard --install-daemonTrình hướng dẫn sẽ dẫn bạn qua việc chọn nhà cung cấp mô hình, đặt khóa API, và cấu hình Gateway. Quá trình này mất khoảng 2 phút.
Xem Thiết lập ban đầu (CLI) để biết tài liệu tham khảo đầy đủ.
Xác minh Gateway đang chạy
openclaw gateway statusBạn sẽ thấy Gateway đang lắng nghe trên cổng 18789.
Mở bảng điều khiển
openclaw dashboardLệnh này mở Control UI trong trình duyệt của bạn. Nếu trang tải được, mọi thứ đang hoạt động.
Gửi tin nhắn đầu tiên
Nhập một tin nhắn trong cuộc trò chuyện của Control UI và bạn sẽ nhận được phản hồi từ AI.
Thay vào đó muốn trò chuyện từ điện thoại? Kênh nhanh nhất để thiết lập là Telegram (chỉ cần mã thông báo bot). Xem Kênh để biết tất cả tùy chọn.
Nâng cao: gắn một bản dựng Control UI tùy chỉnh
Nếu bạn duy trì một bản dựng bảng điều khiển đã bản địa hóa hoặc tùy chỉnh, hãy trỏ
gateway.controlUi.root đến một thư mục chứa các tài sản tĩnh đã dựng
và index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.Sau đó đặt:
{"gateway": { "controlUi": { "enabled": true, "root": "$HOME/.openclaw/control-ui-custom" }}}Khởi động lại Gateway và mở lại bảng điều khiển:
openclaw gateway restartopenclaw dashboardViệc cần làm tiếp theo
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, và nhiều kênh khác.
Kiểm soát ai có thể nhắn tin cho agent của bạn.
Mô hình, công cụ, sandbox, và cài đặt nâng cao.
Trình duyệt, exec, tìm kiếm web, Skills, và Plugin.
Nâng cao: biến môi trường
Nếu bạn chạy OpenClaw bằng tài khoản dịch vụ hoặc muốn dùng đường dẫn tùy chỉnh:
OPENCLAW_HOME— thư mục chính để phân giải đường dẫn nội bộOPENCLAW_STATE_DIR— ghi đè thư mục trạng tháiOPENCLAW_CONFIG_PATH— ghi đè đường dẫn tệp cấu hình
Tài liệu tham khảo đầy đủ: Biến môi trường.