Hướng dẫn cài đặt

Cài đặt OpenClaw

Chọn cách bạn thích. Tất cả đều dẫn đến cùng một CLI.

checklist Yêu cầu hệ thống

javascript Node.js

Node.js 22 trở lên (khuyên dùng bản LTS)

computer OS

Windows 10+, macOS 12+ hoặc Linux (Ubuntu 20.04+, Debian 11+)

memory RAM

Tối thiểu 2 GB RAM, khuyên dùng 4 GB

hard_drive Disk

~500 MB dung lượng ổ đĩa cho cài đặt và dependencies

extension Optional

Tùy chọn: Python 3.10+ (cho một số skill), Git (cho build từ source)

wifi Network

Cần kết nối internet cho API AI. Model local qua Ollama chạy offline được.

Script một dòng lo hết. Khuyên dùng cho đa số. Xem đầy đủ trong tài liệu arrow_forward

Windows (PowerShell)

Chạy PowerShell với quyền Admin để kết quả tốt nhất.

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

Chạy được trên macOS và hầu hết distro Linux.

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified Kiểm tra cài đặt

Chạy các lệnh sau để xác nhận OpenClaw đã cài đúng.

1
$ openclaw --version

Sẽ in ra số phiên bản đã cài (ví dụ: v2026.3.12).

2
$ openclaw doctor

Chạy kiểm tra chẩn đoán môi trường: phiên bản Node.js, dependencies, file cấu hình và kết nối.

3
$ openclaw onboard

Trình hướng dẫn thiết lập tương tác giúp bạn cấu hình API key, kết nối nền tảng chat và cấu hình ban đầu.

settings Cấu hình ban đầu

Sau khi cài, trình hướng dẫn onboard sẽ đưa bạn qua thiết lập. Đây là chức năng từng bước.

1

Chọn nhà cung cấp AI

Chọn Anthropic (Claude), OpenAI (GPT), Google (Gemini) hoặc model local qua Ollama. Bạn có thể đổi nhà cung cấp bất cứ lúc nào trong cấu hình.

2

Thêm API Key

Dán API key từ dashboard nhà cung cấp. Key được lưu local trong file .env — không bao giờ gửi đi đâu ngoài nhà cung cấp AI.

3

Kết nối nền tảng chat

Liên kết WhatsApp (quét QR code), Telegram (dán bot token từ @BotFather), Discord (dán bot token) hoặc bất kỳ nền tảng nào được hỗ trợ.

4

Gửi tin nhắn thử

Gửi tin nhắn cho OpenClaw qua app chat đã kết nối. Nếu nó phản hồi, bạn đã sẵn sàng. Thử: 'Bạn làm được gì?'

.env — Toàn bộ cấu hình lưu trong ~/.openclaw/.env. Bạn có thể sửa file này trực tiếp để đổi nhà cung cấp, thêm API key hoặc điều chỉnh cài đặt. Xem docs.openclaw.ai/configuration để tham khảo đầy đủ.

system_update_alt Nâng cấp OpenClaw

Giữ OpenClaw cập nhật để có tính năng mới nhất, tích hợp và bản vá bảo mật. Cách nâng cấp và chuyển đổi arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

Xem changelog tại github.com/openclaw/openclaw/releases để biết có gì mới trong mỗi phiên bản.

delete_forever Gỡ cài đặt OpenClaw

Nếu bạn cần xóa OpenClaw khỏi hệ thống, hãy làm theo các bước tương ứng với phương thức cài đặt của mình. Cách gỡ cài đặt chi tiết arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

Xóa dữ liệu người dùng (tùy chọn)

Thao tác này sẽ xóa toàn bộ cuộc trò chuyện, kỹ năng, cấu hình và API key của bạn. Hãy sao lưu những gì cần thiết trước khi thực hiện.

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build Khắc phục sự cố

Các vấn đề thường gặp và cách sửa. Thêm mẹo sửa lỗi arrow_forward

Cần giúp đỡ?

Vào Discord để được hỗ trợ cài đặt.

forum Vào Discord menu_book Hướng dẫn cài đặt đầy đủ
hub Tích hợp • article Blog • apps Dự án
❯

Theo dõi tin mới

Nhận thông báo về tính năng mới và tích hợp. Không spam, hủy đăng ký bất cứ lúc nào.