Bắt đầu sử dụng

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 trong khoảng 5 phút. Khi hoàn tất, bạn sẽ có một Gateway đang chạy, phương thức xác thực đã được cấu hình và một phiên trò chuyện hoạt động.

​

Những gì bạn cần

• Node.js 22.22.3+, 24.15+ hoặc 25.9+ (24 là phiên bản mặc định được khuyến nghị)
• 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 khóa

Kiểm tra phiên bản Node bằng node --version. Người dùng Windows: ứng dụng Windows Hub gốc là cách dễ nhất để sử dụng trên máy tính. Trình cài đặt PowerShell và các phương thức chạy Gateway trên WSL2 cũng được hỗ trợ. Xem Windows. Cần cài đặt Node? Xem Thiết lập Node.

​

Thiết lập nhanh

1. Cài đặt OpenClaw

   macOS / Linux

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   

   Windows (PowerShell)

   iwr -useb https://openclaw.ai/install.ps1 | iex
   

   Các phương thức cài đặt khác (Docker, Nix, npm): Cài đặt.

2. Chạy quy trình thiết lập ban đầu

   openclaw onboard --install-daemon
   

   Trình hướng dẫn sẽ giúp bạn chọn nhà cung cấp mô hình, đặt khóa API và cấu hình Gateway. QuickStart thường chỉ mất vài phút, nhưng việc đăng nhập vào nhà cung cấp, ghép nối kênh, cài đặt daemon, tải xuống qua mạng, thiết lập skills hoặc các plugin tùy chọn có thể khiến toàn bộ quy trình thiết lập ban đầu mất nhiều thời gian hơn. Hãy bỏ qua các bước tùy chọn và quay lại sau bằng openclaw configure.

   Xem Thiết lập ban đầu (CLI) để tham khảo đầy đủ.

3. Xác minh Gateway đang chạy

   openclaw gateway status
   

   Bạn sẽ thấy Gateway đang lắng nghe trên cổng 18789.

4. Mở bảng điều khiển

   openclaw dashboard
   

   Thao tác này mở giao diện điều khiển trong trình duyệt. Nếu giao diện tải được thì mọi thứ đang hoạt động.

5. Gửi tin nhắn đầu tiên

   Nhập một tin nhắn trong phần trò chuyện của giao diện điều khiển và bạn sẽ nhận được phản hồi từ AI.

   Thay vào đó, bạn muốn trò chuyện từ điện thoại? Kênh thiết lập nhanh nhất là Telegram (chỉ cần mã thông báo bot). Xem Các kênh để biết tất cả tùy chọn.

Nâng cao: gắn bản dựng giao diện điều khiển tùy chỉnh

Nếu bạn duy trì một bản dựng bảng điều khiển đã được bản địa hóa hoặc tùy chỉnh, hãy trỏ gateway.controlUi.root đến thư mục chứa các tài nguyên tĩnh đã dựng và index.html.

mkdir -p "$HOME/.openclaw/control-ui-custom"
# Sao chép các tệp tĩnh đã dựng của bạn vào thư mục đó.

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 restart
openclaw dashboard

​

Việc cần làm tiếp theo

Kết nối một kênh

Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo và nhiều nền tảng khác.

Ghép nối và an toàn

Kiểm soát những ai có thể gửi tin nhắn cho tác tử của bạn.

Cấu hình Gateway

Mô hình, công cụ, hộp cát và các cài đặt nâng cao.

Duyệt công cụ

Trình duyệt, thực thi lệnh, 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 sử dụng các đường dẫn tùy chỉnh:

• OPENCLAW_HOME — thư mục chính dùng để phân giải đường dẫn nội bộ
• OPENCLAW_STATE_DIR — ghi đè thư mục trạng thái
• OPENCLAW_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.

​

Liên quan

• Tổng quan về cài đặt
• Tổng quan về các kênh
• Thiết lập