Sau khi giới thiệu về OpenClaw trong bài viết trước, tôi nhận được khá nhiều câu hỏi về cách cài đặt. Nhiều bạn muốn thử nhưng chưa quen với môi trường server, chưa từng SSH vào VPS, hoặc đơn giản là sợ làm sai. Nên hôm nay tôi sẽ hướng dẫn chi tiết từng bước, từ lúc mua VPS cho đến khi OpenClaw chạy ngon lành.
Chuẩn Bị Gì Trước Khi Bắt Đầu?
Trước khi cài đặt, bạn cần có những thứ sau:
- Một VPS chạy Linux — Tôi khuyên dùng Ubuntu 22.04 hoặc Debian 12. Có thể mua từ Vultr, DigitalOcean, Hetzner, hay bất kỳ nhà cung cấp nào bạn thích. Cấu hình tối thiểu: 1 vCPU, 1GB RAM là đủ cho OpenClaw.
- Node.js phiên bản 18 trở lên — OpenClaw được xây dựng trên Node.js, nên đây là yêu cầu bắt buộc.
- Kiến thức cơ bản về terminal — Biết SSH, chạy lệnh cơ bản. Không cần phải pro, chỉ cần quen với việc copy-paste lệnh là được.
Nếu bạn chưa từng làm việc với VPS, đừng lo. Tôi sẽ giải thích từng lệnh một cách dễ hiểu nhất.
Bước 1: Kết Nối SSH Vào VPS
Sau khi mua VPS, bạn sẽ nhận được IP address, username (thường là root), và password hoặc SSH key. Mở terminal trên máy tính và chạy:
ssh root@IP_CỦA_BẠN
Nhập password khi được hỏi. Nếu kết nối thành công, bạn sẽ thấy dấu nhắc lệnh của server, thường là root@server-name:~#.
Mẹo nhỏ: Nếu bạn dùng Windows, có thể dùng PowerShell hoặc cài đặt Windows Terminal. Trên Mac thì Terminal có sẵn. Trên Linux thì tất nhiên rồi.
Bước 2: Cập Nhật Hệ Thống
Đây là thói quen tốt trước khi cài bất cứ thứ gì lên server mới:
apt update && apt upgrade -y
Quá trình này có thể mất vài phút tùy vào số lượng bản cập nhật. Chờ xong rồi đi tiếp.
Bước 3: Cài Đặt Node.js
OpenClaw yêu cầu Node.js 18+. Cách dễ nhất để cài là dùng NodeSource repository:
curl -fsSL https://deb.nodesource.com/setup_22.x | bash - apt install -y nodejs
Sau khi cài xong, kiểm tra phiên bản:
node --version npm --version
Bạn sẽ thấy Node.js phiên bản 22.x và npm đi kèm. Nếu đúng thì chúng ta sẵn sàng cho bước tiếp theo.
Bước 4: Cài Đặt OpenClaw
Đây là bước quan trọng nhất, nhưng cũng đơn giản nhất. Chỉ cần một lệnh:
npm install -g openclaw
Lệnh này sẽ tải và cài đặt OpenClaw toàn cục trên hệ thống. Quá trình cài có thể mất 1-2 phút. Sau khi xong, kiểm tra:
openclaw --version
Nếu thấy số phiên bản hiện ra, chúc mừng, bạn đã cài đặt thành công.
Bước 5: Chạy Onboarding
OpenClaw có một trình hướng dẫn thiết lập rất thân thiện. Chạy lệnh sau để bắt đầu:
openclaw onboard
Trình onboard sẽ hỏi bạn một số câu hỏi:
- Tên của bạn — OpenClaw sẽ dùng để gọi bạn
- Múi giờ — Để AI biết giờ địa phương của bạn
- Ngôn ngữ ưu tiên — Tôi chọn tiếng Việt tất nhiên
- API key — Bạn cần có API key từ nhà cung cấp AI model (OpenAI, Anthropic, hoặc các provider khác). Đây là thứ duy nhất bạn cần chuẩn bị trước và không miễn phí.
Quá trình onboard sẽ tạo ra thư mục ~/.openclaw với các file cấu hình cơ bản. Đây chính là ngôi nhà của OpenClaw trên server của bạn.
Bước 6: Khởi Động Gateway
Gateway là cánh cửa kết nối giữa OpenClaw và các kênh chat (Telegram, Discord, web…). Để khởi động:
openclaw gateway start
Nếu mọi thứ ổn, bạn sẽ thấy thông báo gateway đang chạy. Nhưng trên VPS, bạn muốn nó chạy liên tục kể cả khi đóng terminal. Có vài cách để làm điều này:
Dùng systemd (khuyên dùng)
Tạo file service:
cat > /etc/systemd/system/openclaw.service << 'EOF' [Unit] Description=OpenClaw Gateway After=network.target [Service] Type=simple User=root ExecStart=/usr/bin/openclaw gateway start --foreground Restart=always RestartSec=10 [Install] WantedBy=multi-user.target EOF
Kích hoạt và khởi động:
systemctl daemon-reload systemctl enable openclaw systemctl start openclaw
Kiểm tra trạng thái:
systemctl status openclaw
Nếu thấy active (running) thì ổn rồi. Giờ OpenClaw sẽ tự động khởi động lại mỗi khi server reboot.
Dùng screen hoặc tmux (cách nhanh)
Nếu không muốn phức tạp với systemd:
apt install -y screen screen -dmS openclaw openclaw gateway start --foreground
Gateway sẽ chạy trong background. Muốn xem log thì: screen -r openclaw. Thoát screen bằng Ctrl+A rồi D.
Bước 7: Trải Nghiệm Lần Đầu
Để kiểm tra OpenClaw đã hoạt động, bạn có thể chat trực tiếp qua CLI:
openclaw chat
Một giao diện chat sẽ hiện ra trong terminal. Thử gửi tin nhắn và xem AI phản hồi. Nếu nhận được câu trả lời, xin chúc mừng — OpenClaw của bạn đã sống!
Nhưng chat trong terminal thì không tiện lắm. Bước tiếp theo nên làm là kết nối OpenClaw với Telegram để chat mọi lúc mọi nơi trên điện thoại. Tôi sẽ hướng dẫn chi tiết trong bài viết tiếp theo về kết nối Telegram.
Những Lỗi Thường Gặp Và Cách Khắc Phục
Lỗi command not found khi chạy openclaw
Nguyên nhân: npm global bin không nằm trong PATH. Khắc phục:
export PATH=$PATH:$(npm config get prefix)/bin
Thêm dòng này vào ~/.bashrc để lưu vĩnh viễn.
Lỗi kết nối API
Nếu OpenClaw báo không kết nối được đến API provider, kiểm tra:
- API key đã nhập đúng chưa
- VPS có kết nối internet không (
ping google.com) - Nếu dùng OpenAI, thử kiểm tra key còn hạn mức không
Gateway không giữ được trạng thái running
Xem log để biết nguyên nhân:
journalctl -u openclaw -n 50 --no-pager
Nguyên nhân phổ biến nhất là thiếu API key hoặc cấu hình sai. Xem lại bước onboard.
Lỗi permission
Nếu cài bằng user thường và gặp lỗi permission khi chạy:
sudo chown -R $USER:$USER ~/.openclaw
Một Số Mẹo Từ Kinh Nghiệm Cá Nhân
- Chọn VPS gần bạn — Tôi ở Việt Nam nên chọn data center ở Singapore. Latency thấp hơn rất nhiều so với US hay EU.
- Dùng SSH key thay vì password — Bảo mật hơn và không cần nhập password mỗi lần. Copy SSH key lên server:
ssh-copy-id root@IP - Cấu hình firewall cơ bản — Chỉ mở port cần thiết (22 cho SSH, port gateway nếu cần):
ufw allow 22 && ufw enable - Theo dõi tài nguyên — OpenClaw không tốn nhiều RAM, nhưng nên kiểm tra định kỳ bằng
htopđể đảm bảo server không bị quá tải.
Tổng Kết
Cài đặt OpenClaw không hề khó như tôi tưởng ban đầu. Toàn bộ quá trình từ lúc SSH vào VPS đến khi chat được với AI mất khoảng 15-20 phút, kể cả lần đầu tiên. Quan trọng nhất là chuẩn bị sẵn API key và làm theo từng bước.
Sau khi cài xong, bạn đã có một trợ lý AI chạy trên server riêng của mình. Không ai có thể đọc tin nhắn của bạn, không ai có thể ngắt service của bạn. Đó là sức mạnh của self-hosted.
Như tôi đã nói trong bài giới thiệu về OpenClaw, đây mới chỉ là bước đầu. Trong các bài tiếp theo, tôi sẽ hướng dẫn cách kết nối OpenClaw với Telegram để chat trên điện thoại, và cách tùy chỉnh personality cho AI để nó trở thành một người thực sự của bạn. Cùng theo dõi nhé.
Các Bài Viết Trong Series
- Phần 1: OpenClaw — Trợ lý AI cá nhân tự host (Giới thiệu)
- Phần 2: Cài Đặt OpenClaw Trên Linux VPS (bài này)
- Phần 3: Kết Nối OpenClaw Với Telegram
- Phần 4: Tùy Chỉnh Personality Cho OpenClaw
- Phần 5: Hệ Thống Skills Của OpenClaw
- Phần 6: Memory Và Tự Động Hóa Với OpenClaw
- Phần 7: Ứng Dụng Thực Tế OpenClaw
- Phần 8: Tips & Tricks OpenClaw
