Cài đặt và chạy OpenClaw lần đầu trên mọi nền tảng

Cài đặt OpenClaw trên macOS, Linux hoặc Windows và hoàn thành tác vụ hỗ trợ AI đầu tiên của bạn trong vòng chưa đầy 5 phút

Từ con số 0 đến khi chạy chỉ trong 5 phút

Hầu hết các hướng dẫn "bắt đầu" đều giấu lệnh cài đặt thực tế dưới nhiều đoạn giải thích. Hãy bỏ qua phần đó. Đây là những gì bạn cần và cách để chạy nó.

Đến cuối bài học này, bạn sẽ cài đặt được OpenClaw và có thể giao tiếp với mô hình AI.

Điều kiện tiên quyết: Node.js

OpenClaw cần Node.js phiên bản 22.14 trở lên (khuyến nghị Node 24). Kiểm tra xem bạn đã có chưa:

node --version

Nếu thấy phiên bản v22.14.0 trở lên, bạn đã sẵn sàng. Nếu không, hãy cài đặt nó:

macOS:

brew install node

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows: Tải xuống trình cài đặt từ nodejs.org và chạy nó. Chọn phiên bản LTS.

✅ Kiểm tra nhanh: Lệnh nào kiểm tra phiên bản Node.js của bạn?

Đáp án: node --version

Cài đặt OpenClaw

Một lệnh:

npm install -g openclaw

Lệnh này cài đặt lệnh openclaw toàn hệ thống. Xác minh nó đã hoạt động:

openclaw --version

Bạn sẽ thấy số phiên bản. Nếu bạn nhận được "command not found," đường dẫn toàn hệ thống npm của bạn không có trong PATH - hãy chạy npm config get prefix và thêm thư mục /bin đó vào cấu hình shell của bạn.

Quy trình thiết lập ban đầu

Đây là lệnh quan trọng:

openclaw onboard --install-daemon

Lệnh này sẽ khởi chạy quy trình thiết lập, hướng dẫn bạn qua các bước sau:

1. Cấu hình gateway - Nơi OpenClaw chạy (mặc định là cục bộ)
2. Xác thực mô hình - Kết nối với nhà cung cấp AI (chọn bất kỳ nhà cung cấp nào bạn có - chúng ta sẽ thêm nhiều nhà cung cấp khác trong bài học 3 - 5)
3. Thiết lập không gian làm việc - Tạo thư mục ~/.openclaw/ với các file agent của bạn
4. Cài đặt Daemon - Giữ cho OpenClaw chạy ngầm
5. Các kênh tùy chọn - Telegram, Discord, WhatsApp (bỏ qua các kênh này hiện tại)

Làm theo hướng dẫn. Đối với nhà cung cấp mô hình, hãy chọn nhà cung cấp mà bạn đã có API key. Nếu bạn chưa có, hãy chọn "Skip" - chúng ta sẽ thiết lập chúng trong các bài học tiếp theo.

Nhiệm vụ đầu tiên của bạn

Sau khi quá trình thiết lập ban đầu hoàn tất, hãy thử lệnh này:

openclaw chat

Sau đó gõ:

Kiểm tra xem hàm này có lỗi không:

function calculateTotal(items) {
  let total = 0;
  for (let i = 0; i <= items.length; i++) {
    total += items[i].price * items[i].quantity;
  }
  return total;
}

OpenClaw sẽ bắt lỗi sai lệch một đơn vị (<= phải là <). Nếu bắt được, thiết lập của bạn đang hoạt động.

Hiểu về không gian làm việc

OpenClaw đã tạo một không gian làm việc tại ~/.openclaw/. Đây là nội dung bên trong:

~/.openclaw/
├── config.yaml          # Cài đặt gateway và nhà cung cấp
├── workspace/
│   ├── SOUL.md          # Tính cách agent của bạn (bài học 7)
│   ├── AGENTS.md        # Quy tắc hoạt động (bài học 7)
│   ├── USER.md          # Thông tin về bạn
│   └── memory/          # Các file bộ nhớ dài hạn
└── logs/                # Nhật ký phiên và việc sử dụng token

Đừng chỉnh sửa những file này ngay - chúng ta sẽ tùy chỉnh chúng trong bài học 7. Hiện tại, chỉ cần biết chúng tồn tại.

✅ Kiểm tra nhanh: Theo mặc định, OpenClaw lưu trữ các file không gian làm việc của nó ở đâu?

Đáp án: ~/.openclaw/workspace/

Hãy tự mình thử

Mở terminal và chạy theo trình tự đầy đủ này:

# 1. Kiểm tra Node.js
node --version

# 2. Cài đặt OpenClaw
npm install -g openclaw

# 3. Xác minh cài đặt
openclaw --version

# 4. Chạy quá trình thiết lập ban đầu
openclaw onboard --install-daemon

# 5. Bắt đầu trò chuyện
openclaw chat

Nếu mọi thứ hoạt động, hãy yêu cầu OpenClaw giải thích chức năng của các file trong ~/.openclaw/workspace/. Nó sẽ mô tả SOUL.md, AGENTS.md và hệ thống bộ nhớ - chính xác là những gì chúng ta sẽ tìm hiểu trong bài học 7.

Hoàn tất cài đặt và gửi message đầu tiên

CLI chỉ là bước khởi đầu. OpenClaw còn cần một mô hình và Gateway đang hoạt động.

Chọn mô hình và khởi động Gateway

OpenClaw đóng vai trò là runtime, còn mô hình sẽ cung cấp khả năng suy luận. Hãy bắt đầu với một mô hình cụ thể; danh mục mô hình sẽ giúp so sánh chi phí, ngữ cảnh và năng lực của từng loại.

Quá trình thiết lập ban đầu sẽ cấu hình nhà cung cấp, workspace và dịch vụ Gateway. Lưu ý không đưa thông tin xác thực vào các câu lệnh (prompt) hay file được chia sẻ.

Xác minh cài đặt

Thực hiện các bước kiểm tra sau theo đúng thứ tự:

openclaw --version

openclaw doctor

openclaw gateway status

openclaw dashboard

Một hệ thống được cài đặt đúng cách sẽ hiển thị phiên bản, vượt qua các bước kiểm tra của lệnh doctor và gateway probe, đồng thời mở ra Dashboard đã được xác thực. Nếu bước kiểm tra Gateway probe thất bại, hãy xem thông báo lỗi gần nhất của Gateway.

Gửi message thử nghiệm

Từ Dashboard, hãy thử nhập:

Tell me which model you are using and create a short system status summary.

Hãy cho tôi biết bạn đang sử dụng mô hình nào và tạo một bản tóm tắt ngắn gọn về trạng thái hệ thống.

Phản hồi đầy đủ từ hệ thống xác nhận rằng quá trình cài đặt đã hoàn tất. Bạn cũng có thể kiểm tra thông qua Terminal:

openclaw agent --message "Hello, are you working?"

Sau đó, hãy thêm một kênh (channel). 

Cách cài đặt OpenClaw Skill

OpenClaw Skill là một thư mục được xây dựng dựa trên file SKILL.md; file này quy định thời điểm và cách thức để agent sử dụng một tính năng cụ thể.

Trước khi cài đặt, hãy kiểm tra thông tin về nhà phát hành, nguồn gốc, các dependency, API key, các lệnh gọi mạng và kết quả quét bảo mật:

openclaw skills verify @owner/skill-name

Cài đặt Skill vào workspace hiện tại:

openclaw skills install @owner/skill-name

Chỉ thêm tham số --global khi tất cả các agent cục bộ đều cần quyền truy cập. Hãy chạy lệnh openclaw skills check, hoàn tất các cấu hình còn thiếu và thử nghiệm một yêu cầu có thể đảo ngược (reversible request) trước khi kết nối các tài khoản quan trọng.

MyClaw Skills Hub hiển thị các danh mục, số lượt cài đặt, thông tin nguồn và các yêu cầu cần thiết. Hãy bắt đầu với một nhu cầu thực tế. Ví dụ: Google Workspace Skill cho phép kết nối Gmail, Calendar, Drive, Docs và Sheets.

Khắc phục sự cố

Những điểm chính cần lưu ý

• OpenClaw yêu cầu Node.js 22.14 trở lên và được cài đặt thông qua lệnh `npm install -g openclaw`.
• Lệnh `openclaw onboard --install-daemon` sẽ xử lý tất cả các thiết lập ban đầu trong một quy trình hướng dẫn duy nhất.
• Không gian làm việc của bạn nằm tại `~/.openclaw/` với các file cấu hình, file agent và bộ nhớ.
• Bạn có thể bắt đầu trò chuyện ngay lập tức với openclaw chat.