OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

First steps

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.19+, 23.11+ hoặc 24+ (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

Thiết lập nhanh

  • Cài đặt OpenClaw

    macOS / Linux

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

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

    Windows (PowerShell)

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

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

    bash
    openclaw onboard --install-daemon

    Trình hướng dẫn sẽ giúp bạn chọn nhà cung cấp mô hình, thiết lập 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) để biết tài liệu tham khảo đầy đủ.

  • Xác minh Gateway đang chạy

    bash
    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

    bash
    openclaw dashboard

    Lệnh 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.

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

    Bạn muốn trò chuyện bằng đ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 một 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 đặt gateway.controlUi.root trỏ đến thư mục chứa các tài nguyên tĩnh đã dựng và tệp index.html.

    bash
    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 đó thiết lập:

    json
    {"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:

    bash
    openclaw gateway restartopenclaw 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 người có thể nhắn tin cho tác nhân của bạn.
    Cấu hình Gateway

    Mô hình, công cụ, môi trường cô lập và các thiết lập nâng cao.
    Khám phá công cụ

    Trình duyệt, thực thi lệnh, tìm kiếm web, Skills và các 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 để 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.

    Nội dung liên quan

    Was this useful?
    On this page

    On this page