Hướng dẫn cài đặt Openclaw trên Windows chi tiết từng bước 2026

Yêu cầu phần cứng và hệ điều hành tối thiểu

Trước khi bắt đầu, hãy kiểm tra máy tính của bạn đáp ứng các điều kiện sau:

• Hệ điều hành: Windows 10 hoặc Windows 11

• RAM: Tối thiểu 2-4 GB, khuyến nghị 8 GB

• CPU: Tối thiểu 2 nhân

• Ổ cứng trống: Tối thiểu 1 GB, khuyến nghị 4 GB

• Môi trường bắt buộc: Node.js, Git, npm/pnpm

Lưu ý: Nếu bạn chưa tin tưởng vào bảo mật của OpenClaw, có thể cài lên một máy ảo hoặc VPS riêng trước khi thử trên máy chính.

Hướng dẫn cài đặt OpenClaw trên Windows từng bước chi tiết

Toàn bộ quá trình gồm 5 giai đoạn chính:

• Bước 1: Cài đặt Node.js và pnpm

• Bước 2: Cài đặt Git

• Bước 3: Tải mã nguồn OpenClaw

• Bước 4: Build và khởi chạy

• Bước 5: Cấu hình mô hình AI

Bước 1 - Cài đặt Node.js và kiểm tra npm

OpenClaw được xây dựng trên nền Node.js, vì vậy đây là thứ bạn cần cài đầu tiên. OpenClaw yêu cầu Node.js phiên bản v22 trở lên.

1.1. Tải Node.js

• Truy cập trang chủ Node.js tại nodejs.org

• Nhấn vào "Get Node.js"

• Chọn phiên bản có nhãn (LTS) - đây là phiên bản ổn định được khuyến nghị

• Chọn "Windows Installer (.msi)" để tải về

1.2. Cài đặt Node.js

• Mở file vừa tải xuống (nhấp đúp chuột)

• Nhấn Next → chấp nhận điều khoản → Next → Next → Install

• Đợi vài giây và chọn Finish

1.3. Kiểm tra Node.js và npm

Mở Command Prompt với quyền Admin: nhấn vào biểu tượng tìm kiếm ???? → gõ cmd → chọn "Run as administrator"

Tại cửa sổ cmd, gõ lần lượt:

node -v

Nếu kết quả hiện ra dạng v24.14.0 (hoặc v22, v23 tùy phiên bản bạn chọn) → Node.js đã cài thành công.

Tiếp theo, gõ:

npm -v

Kết quả hiện số phiên bản (ví dụ 11.9.0) → npm cũng sẵn sàng.

1.4. Cài đặt pnpm

pnpm là công cụ quản lý gói của Node.js, nhanh hơn và tiết kiệm dung lượng hơn npm thông thường. Tại cửa sổ cmd, gõ:

npm install -g pnpm

Sau khi cài xong, màn hình hiện added 1 package là thành công. Kiểm tra lại bằng:

pnpm -v

Hiện số phiên bản (ví dụ 10.32.1) → pnpm đã sẵn sàng.

Bước 2 - Cài đặt Git

Git là công cụ bắt buộc để tải và quản lý mã nguồn OpenClaw.

2.1. Tải Git

• Vào trang chính thức: git-scm.com

• Nhấn "Install for Windows"

• Chọn "Git for Windows/x64 Setup" và tải về

2.2. Cài đặt Git

• Mở file tải về → chọn Yes ở hộp thoại bảo mật

• Nhấn Install và chờ cài xong

• Tích chọn "Launch Git Bash", bỏ tích "View Release Notes" → nhấn Finish

2.3. Kiểm tra Git

Tại cửa sổ Git Bash vừa mở, gõ:

git --version

Kết quả hiện git version 2.53.0 (hoặc phiên bản tương tự) → Git đã cài thành công.

Bước 3 - Tải và giải nén mã nguồn OpenClaw

3.1. Tải mã nguồn

• Vào trang GitHub chính thức của OpenClaw: github.com/openclaw/openclaw

• Nhấn nút "Code" màu xanh lá

• Chọn "Download ZIP"

3.2. Giải nén và tổ chức thư mục

• Tạo một thư mục mới trên ổ D, đặt tên là ai (hoặc tên tùy ý)

• Copy file openclaw-main.zip vào thư mục ai

• Nhấp chuột phải vào file ZIP → chọn "Extract Here" để giải nén

Kết quả: bạn sẽ có thư mục openclaw-main bên trong thư mục ai.

3.3. Cài đặt các thành phần phụ thuộc

Mở cmd, điều hướng vào thư mục dự án bằng cách gõ lần lượt:

d: → cd ai → cd openclaw → cd openclaw-main

Khi terminal hiển thị đường dẫn D:aiopenclawopenclaw-main> là bạn đã vào đúng vị trí. Tiếp theo, chạy lệnh:

pnpm install

Hệ thống sẽ tự động tải tất cả các thành phần cần thiết. Quá trình này có thể mất 10-15 phút tùy tốc độ mạng.

Gặp lỗi giữa chừng do mạng không ổn định? Không sao - chỉ cần gõ lại pnpm install và chạy tiếp. Lệnh này an toàn để chạy nhiều lần.

Khi màn hình hiển thị Done in Xm Xs using pnpm vXX → cài đặt thành phần phụ thuộc thành công!

Bước 4 - Build và khởi chạy OpenClaw

4.1. Mở Git Bash

Truy cập vào thư mục dự án D:aiopenclawopenclaw-main, nhấp chuột phải vào vùng trắng trong thư mục → chọn "Git Bash Here".

Hoặc mở Git Bash từ thanh tìm kiếm rồi điều hướng thủ công bằng lệnh:

cd /d/ai/openclaw/openclaw-main

4.2. Build dự án

Tại Git Bash, chạy:

pnpm build

Chờ quá trình hoàn tất. Khi thấy các thông báo dạng Copied X files, rolldown Finished in Xms → build thành công.

4.3. Khởi chạy OpenClaw

Gõ lần lượt hai lệnh sau:

pnpm start

Sau đó chạy Gateway:

pnpm openclaw gateway

Khi thấy địa chỉ http://127.0.0.1:18789 xuất hiện trong terminal, hãy copy và dán vào trình duyệt. Giao diện OpenClaw sẽ hiện ra - bạn đã cài đặt thành công!

Bước 5 - Cấu hình mô hình AI cho OpenClaw

Trước tiên, dừng dịch vụ đang chạy bằng cách nhấn Ctrl + C trong Git Bash.

Tiếp theo, chạy lệnh cấu hình:

pnpm openclaw configure

Hệ thống sẽ hỏi từng mục:

• Where will the Gateway run? → Chọn Local (this machine)

• Select sections to configure → Chọn Model

• Model/auth provider → Tùy chọn theo nhu cầu. Ví dụ: MiniMax (chi phí thấp, chất lượng tốt), hoặc OpenAI, Anthropic, Google...

• MiniMax auth method → Chọn MiniMax M2.5 (CN) nếu dùng endpoint Trung Quốc

• Dán API Key của bạn vào khi được hỏi → nhấn Enter

Sau khi cấu hình xong, màn hình hiện Configure complete. → khởi động lại gateway:

pnpm openclaw gateway

Truy cập lại http://127.0.0.1:18789 để bắt đầu sử dụng.

Những lỗi thường gặp khi cài đặt OpenClaw trên Windows

Dù hướng dẫn cài đặt OpenClaw trên Windows khá chi tiết, vẫn có một số lỗi phổ biến mà người dùng hay gặp phải:

Lỗi pnpm install bị gián đoạn giữa chừng

Nguyên nhân: Mạng không ổn định, gói tải về bị timeout.

Cách xử lý: Chỉ cần gõ lại pnpm install. Lệnh này sẽ tiếp tục từ nơi bị dừng, không cần bắt đầu lại từ đầu.

Lỗi node hoặc pnpm không được nhận diện sau khi cài

Nguyên nhân: Windows chưa cập nhật biến môi trường PATH.

Cách xử lý: Đóng hoàn toàn cửa sổ cmd hoặc Git Bash, mở lại và thử gõ lại lệnh. Nếu vẫn không được, khởi động lại máy tính và thử tiếp.

Lỗi khi chạy pnpm build - thiếu thành phần

Nguyên nhân: pnpm install chưa hoàn tất hoặc bị lỗi ở bước trước.

Cách xử lý: Chạy lại pnpm install cho đến khi thấy thông báo Done, sau đó mới chạy pnpm build.

Cách sử dụng lại OpenClaw sau khi tắt máy tính

Nhiều người lo lắng rằng sau khi tắt máy sẽ phải cài lại toàn bộ. Hoàn toàn không cần thiết.

Chỉ cần thực hiện 2 bước sau mỗi lần muốn dùng:

• Bước 1: Mở Git Bash và điều hướng vào thư mục dự án bằng lệnh: cd /d/ai/openclaw/openclaw-main

• Bước 2: Chạy gateway: pnpm openclaw gateway

Địa chỉ 127.0.0.1:18789 hiện ra → dán vào trình duyệt → dùng ngay.

Câu hỏi thường gặp về cài đặt OpenClaw trên Windows

OpenClaw có miễn phí không?

OpenClaw là phần mềm mã nguồn mở, miễn phí hoàn toàn. Bạn chỉ cần trả phí cho API key của mô hình AI bạn chọn sử dụng (ví dụ: OpenAI, MiniMax...).

Có thể chạy OpenClaw trên Windows 10 không?

Hoàn toàn được. OpenClaw hỗ trợ Windows 10 và Windows 11, miễn là máy đáp ứng cấu hình tối thiểu đã nêu ở trên.

Nên chọn mô hình AI nào để dùng với OpenClaw?

Nếu bạn mới bắt đầu và muốn chi phí thấp, MiniMax M2.5 là lựa chọn hợp lý - ngữ cảnh lên đến 195k token và giá rất cạnh tranh. Nếu cần độ chính xác cao hơn, cân nhắc Claude (Anthropic) hoặc GPT-4o (OpenAI).

Hướng dẫn cài đặt OpenClaw trên Windows này đã trình bày toàn bộ quy trình theo thứ tự: từ cài Node.js, pnpm, Git, tải mã nguồn, build, đến cấu hình mô hình AI. Nếu bạn làm đúng từng bước và không bỏ qua phần kiểm tra sau mỗi giai đoạn, khả năng thành công là rất cao.

Có vấn đề gì phát sinh trong quá trình cài đặt, hãy đọc lại phần lỗi thường gặp hoặc vào nhóm Zalo AI Update của Vinalink Academy để được hỗ trợ bạn nhé !