English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

Bắt đầu

Cài đặt OpenClaw, chạy onboarding và trò chuyện với trợ lý AI của bạn — tất cả 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ấu hình, và một phiên trò chuyện hoạt động.

Bạn cần gì

  • Node.js — khuyến nghị Node 24 (cũng hỗ trợ Node 22.14+)
  • Một API key từ nhà cung cấp mô hình (Anthropic, OpenAI, Google, v.v.) — onboarding sẽ nhắc bạn nhập

Thiết lập nhanh

  • Cài đặt OpenClaw

    macOS / Linux

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

    Quy trình tập lệnh cài đặt

    Windows (PowerShell)

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

  • Chạy onboarding

    openclaw onboard --install-daemon

    Trình hướng dẫn sẽ đưa bạn qua việc chọn nhà cung cấp mô hình, đặt API key, và cấu hình Gateway. Quá trình này mất khoảng 2 phút.

    Xem Onboarding (CLI) để biết tài liệu tham chiếu đầy đủ.

  • 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.

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

    openclaw dashboard

    Lệnh này mở Control UI trong trình duyệt của bạn. Nếu nó 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 phần trò chuyện của Control UI và bạn sẽ nhận được phản hồi từ AI.

    Muốn trò chuyện từ điện thoại thay vào đó? 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 kế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 nguyên tĩnh đã dựng của bạn 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 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 kênh khác.
    Ghép nối và an toàn

    Kiểm soát ai có thể nhắn tin cho agent của bạn.
    Cấu hình Gateway

    Mô hình, công cụ, sandbox và thiết lập nâng cao.
    Duyệt công cụ

    Trình duyệt, exec, tìm kiếm web, Skills và plugins.
    Nâng cao: biến môi trường

    Nếu bạn chạy OpenClaw dưới dạng tài khoản dịch vụ hoặc muốn đườ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ái
    • OPENCLAW_CONFIG_PATH — ghi đè đường dẫn tệp cấu hình

    Tài liệu tham chiếu đầy đủ: Biến môi trường.

    Liên quan