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.

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.