Yêu Cầu Hệ Thống

Hệ điều hành: Windows 11 (64-bit)
RAM: Tối thiểu 8GB (khuyên dùng 16GB)
Dung lượng đĩa: Tối thiểu 5GB trống
CPU: Hỗ trợ 64-bit, khuyên dùng Intel/AMD đa lõi

Bước 1: Cài Đặt PowerShell 7

OpenClaw hoạt động tốt nhất với PowerShell 7 trở lên. Nếu bạn chưa có, hãy cài đặt:

1. Mở Microsoft Store

Nhấn Windows + S
Gõ “Microsoft Store” và mở ứng dụng

2. Tìm và cài PowerShell 7

Trong Microsoft Store, tìm kiếm: PowerShell 7
Chọn gói “PowerShell 7” (do Microsoft phát hành)
Nhấn “Cài đặt”

3. Hoặc tải từ GitHub (nếu không dùng Store)

Tải từ: https://github.com/PowerShell/PowerShell/releases/latest
Tải file .msi cho Windows x64
Chạy file cài đặt với quyền Administrator

4. Khởi động lại Terminal

Mở Terminal mới và kiểm tra phiên bản:

pwsh --version

Kết quả phải là 7.x trở lên

Bước 2: Cài Đặt Node.js

OpenClaw yêu cầu Node.js phiên bản 18 trở lên:

1. Tải Node.js

Truy cập: https://nodejs.org/
Tải phiên bản LTS (hiện tại là 20.x)

2. Cài đặt Node.js

Chạy file .msi vừa tải
Chọn “Add to PATH” khi được hỏi
Tick chọn “Automatically install the necessary tools” nếu có

3. Khởi động lại Terminal

Mở PowerShell 7 mới
Kiểm tra:

node --version
npm --version

Cả hai lệnh phải trả về phiên bản > 18.0.0 và > 9.0.0

Bước 3: Cài Đặt OpenClaw

1. Mở PowerShell 7 với quyền Administrator

Nhấn Windows + X
Chọn “Terminal (Admin)” hoặc “PowerShell (Admin)”
Đảm bảo cửa sổ mở với PowerShell 7 (kiểm tra dòng trên cùng)

2. Cài đặt OpenClaw toàn cục

npm install -g openclaw@latest

3. Nếu gặp lỗi với npm, dùng lệnh có force

npm install -g openclaw@latest --force

4. Kiểm tra cài đặt

openclaw --version

Phải trả về phiên bản OpenClaw

Bước 4: Khởi Tạo Dự Án OpenClaw

1. Tạo thư mục dự án

mkdir C:\OpenClaw\MyProject
cd C:\OpenClaw\MyProject

2. Khởi tạo dự án

openclaw init

Chọn cấu hình phù hợp (main hoặc dev)
Hệ thống sẽ tạo cấu trúc thư mục và file cấu hình

3. Cài đặt các package cần thiết

openclaw install

Bước 5: Cấu Hình Cơ Bản

1. Mở file cấu hình

Mở thư mục C:\OpenClaw\MyProject trong VSCode hoặc trình soạn thảo yêu thích
Mở file config.yaml hoặc openclaw.json

2. Cấu hình cơ bản

server:
  port: 3000
  host: "localhost"

models:
  primary: "gpt-4o"  # hoặc mô hình bạn có sẵn
  fallback: "claude-3-opus"

plugins:
  enabled:
    - "web-search"
    - "file-access"
    - "code-execution"

Bước 6: Khởi Động OpenClaw

1. Chạy Gateway Service

openclaw gateway start

2. Khởi động ứng dụng chính

openclaw start

3. Truy cập giao diện

Mở trình duyệt
Truy cập: http://localhost:3000
Nếu có lỗi, kiểm tra cổng khác như 3001, 3002

Bước 7: Kiểm Tra Hoạt Động

1. Trong giao diện web

Gửi thử tin nhắn “Hello”
Kiểm tra xem có phản hồi không
Thử các lệnh cơ bản như /status, /help

2. Trong PowerShell

Kiểm tra các tiến trình đang chạy:

openclaw status

Khắc Phục Sự Cố Thường Gặp

1. Lỗi Permission

Dấu hiệu: Không thể cài đặt global package
Giải pháp: Chạy PowerShell với quyền Administrator

2. Lỗi Port đã dùng

Dấu hiệu: Không thể khởi động, báo port đang dùng
Giải pháp: Thay đổi port trong config.yaml sang 3001, 3002, v.v.

3. Lỗi Node.js không nhận diện

Dấu hiệu: node không được nhận diện
Giải pháp: Khởi động lại terminal hoặc thêm Node.js vào PATH thủ công

4. Lỗi mạng khi cài đặt

Dấu hiệu: npm install thất bại do timeout
Giải pháp:

npm config set registry https://registry.npmjs.org/
npm cache clean --force

5. Lỗi gateway không khởi động

Dấu hiệu: openclaw gateway start thất bại
Giải pháp:

openclaw gateway stop
openclaw gateway start

Bảo Trì Định Kỳ

Cập nhật OpenClaw

npm install -g openclaw@latest --force
openclaw gateway restart

Kiểm tra phiên bản

openclaw --version
npm list -g openclaw

Dọn dẹp cache

npm cache clean --force
openclaw cleanup

Kết Luận

Bạn đã cài đặt thành công OpenClaw trên Windows 11! Bây giờ bạn có thể:

Tùy chỉnh các plugin theo nhu cầu
Kết nối với các dịch vụ AI khác
Phát triển các skill và workflow riêng
Sử dụng như một trợ lý AI cá nhân

Nếu gặp bất kỳ vấn đề nào, hãy kiểm tra lại từng bước trong hướng dẫn này và đảm bảo bạn đang sử dụng PowerShell 7.