Cài OpenClaw trên Linux: Ubuntu, Debian, Fedora + Deploy VPS Production (2026)

Linux là môi trường lý tưởng nhất để chạy OpenClaw — đây chính là nền tảng mà OpenClaw được thiết kế cho. Không cần WSL, không cần workaround, mọi thứ chạy native. Đặc biệt nếu bạn muốn deploy trên VPS chạy 24/7, Linux là lựa chọn duy nhất hợp lý.

Bài viết này hướng dẫn 2 kịch bản: cài trên Linux desktop (Ubuntu, Fedora…) để dùng cá nhân, và deploy trên Linux VPS cho production chạy liên tục.

Chưa biết OpenClaw cài bằng cách nào? Bài Hướng dẫn cài đặt OpenClaw từ A-Z giới thiệu tổng quan 4 phương pháp. Bài này tập trung vào Linux — từ desktop đến production server.

---

Yêu cầu hệ thống

Thành phần	Desktop (dùng cá nhân)	VPS Production (chạy 24/7)	Cách kiểm tra
Distro	Ubuntu 20.04+ / Debian 11+ / Fedora 36+	Ubuntu 22.04 LTS (khuyến nghị)	cat /etc/os-release
RAM	2 GB tối thiểu	4 GB trở lên	free -h
CPU	1 core	2 vCPU	nproc
Ổ cứng	5 GB trống	10 GB SSD	df -h
Node.js	v22.16+ hoặc v24 (khuyến nghị)	v24	node -v

Lưu ý Node.js: OpenClaw khuyến nghị Node 24. Node 22.16+ cũng hoạt động nhưng không dùng Bun — Gateway có bug với WhatsApp/Telegram khi chạy trên Bun.

---

Phần 1: Cài trên Linux Desktop

Phần này dành cho bạn đang dùng Ubuntu, Debian, Fedora, hoặc bất kỳ distro nào trên máy cá nhân.

Bước 1: Cập nhật hệ thống và cài build tools

Bạn đang làm gì: Cập nhật danh sách package và cài các công cụ build cơ bản mà OpenClaw cần trong quá trình cài đặt (compiler, git, curl).

Ubuntu / Debian:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential

Fedora:

sudo dnf update -y
sudo dnf install -y curl git gcc-c++ make

CentOS / RHEL:

sudo yum update -y
sudo yum install -y curl git gcc-c++ make

Cách biết thành công: Chạy git --version và curl --version — cả hai đều hiện số phiên bản.

Bước 2: Cài Node.js 24

Bạn đang làm gì: Cài Node.js — runtime để OpenClaw chạy. Dùng nvm (Node Version Manager) vì linh hoạt nhất, không cần quyền root cho npm global packages.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Đóng terminal, mở lại (hoặc chạy source ~/.bashrc), rồi:

nvm install 24
nvm use 24

Cách biết thành công: node -v hiện v24.x.x và npm -v hiện số phiên bản.

Cách khác (không dùng nvm): Dùng NodeSource repo — curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt install -y nodejs. Nhưng nvm linh hoạt hơn nếu bạn cần quản lý nhiều version Node.

Bước 3: Cài OpenClaw

Bạn đang làm gì: Cài OpenClaw bằng script chính thức — script tự detect distro, tải đúng bản, và thêm vào PATH.

curl -fsSL https://openclaw.ai/install.sh | bash

Cách biết thành công: Chạy openclaw --version — hiện số phiên bản (ví dụ v2026.4.8). Nếu báo command not found, chạy source ~/.bashrc hoặc đóng terminal mở lại.

Cách khác: npm install -g openclaw@latest — cho kết quả tương tự.

Bước 4: Chạy Onboard Wizard + cài Daemon

Bạn đang làm gì: Chạy trình thiết lập tự động — cài daemon (dịch vụ chạy nền), chọn model AI, nhập API key, kết nối channel nhắn tin.

openclaw onboard --install-daemon

Wizard hướng dẫn bạn qua 4 bước. Chi tiết từng bước xem trong bài tổng quan cài đặt.

Điểm đặc biệt trên Linux: Daemon được cài dưới dạng systemd user service tại ~/.config/systemd/user/openclaw-gateway.service. Đây là cách chuẩn nhất trên Linux — service chạy dưới tài khoản user của bạn, không cần quyền root.

Cách biết thành công: Chạy openclaw doctor — tất cả hiện OK. Kiểm tra thêm:

systemctl --user status openclaw-gateway

Hiện active (running) → daemon đang chạy.

Chưa có API key? Xem Hướng dẫn cấu hình API Key — hướng dẫn lấy key cho Claude, GPT, Gemini, và các model khác.

Bước 5: Giữ daemon chạy sau khi logout

Bạn đang làm gì: Mặc định, systemd user service chỉ chạy khi bạn đang đăng nhập. Lệnh này cho phép service tiếp tục chạy ngay cả khi bạn logout (quan trọng nếu dùng SSH vào server).

sudo loginctl enable-linger $USER

Cách biết thành công: Logout rồi login lại, chạy systemctl --user status openclaw-gateway — vẫn hiện active (running).

Bước 6: Truy cập WebChat

Mở trình duyệt và truy cập:

http://localhost:18789

Giao diện OpenClaw hiện ra. Gửi tin nhắn thử: “Tóm tắt 3 tin công nghệ nổi bật nhất hôm nay” → bot trả lời → bạn đã cài thành công!

---

Phần 2: Deploy trên VPS Production

Phần này dành cho bạn muốn chạy OpenClaw 24/7 trên VPS (DigitalOcean, Vultr, Linode, AWS EC2…). Quy trình cài đặt giống Phần 1 (Bước 1-5), phần dưới đây tập trung vào những thứ chỉ cần khi chạy production.

VPS tối thiểu nên thuê gì?

Nếu chạy OpenClaw cho cá nhân (1 user, vài channel):

• CPU: 1-2 vCPU
• RAM: 2-4 GB
• SSD: 10 GB
• Chi phí: ~$5-10/tháng (DigitalOcean, Vultr)
• OS: Ubuntu 22.04 LTS (ổn định, nhiều tài liệu hỗ trợ)

Không muốn tự quản lý VPS? TryOpenClaw.io lo hết phần infra — từ 99K VND/tháng, bao gồm backup hàng ngày, uptime 99.9%, và cập nhật tự động. Xem so sánh tự cài vs cloud.

Tối ưu khởi động cho VPS nhỏ / ARM

Bạn đang làm gì: Trên VPS cấu hình thấp hoặc ARM (như AWS Graviton), bật Node.js compile cache giúp OpenClaw khởi động nhanh hơn đáng kể.

export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1

Thêm vào systemd service bằng:

systemctl --user edit openclaw-gateway.service

Thêm nội dung:

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

Sau đó reload: systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.

Truy cập Gateway từ xa (SSH Tunnel)

Bạn đang làm gì: Gateway mặc định chỉ lắng nghe trên 127.0.0.1 (localhost) — đây là thiết kế bảo mật. Để truy cập từ laptop/máy khác, dùng SSH tunnel.

Trên máy laptop của bạn (không phải trên VPS), chạy:

ssh -N -L 18789:127.0.0.1:18789 user@your-vps-ip

Rồi mở trình duyệt trên laptop: http://localhost:18789 → giao diện OpenClaw hiện ra, dữ liệu chạy trên VPS.

Cách biết thành công: Trình duyệt trên laptop hiện giao diện OpenClaw WebChat.

Giữ lệnh SSH chạy nền: Thêm flag -f (chạy background): ssh -f -N -L 18789:127.0.0.1:18789 user@your-vps-ip. Hoặc dùng autossh để tự reconnect khi mất kết nối.

Truy cập từ xa bằng Tailscale (alternative)

Nếu bạn dùng Tailscale (VPN mesh miễn phí), cấu hình đơn giản hơn SSH tunnel:

Thêm vào ~/.openclaw/openclaw.json:

{
  "gateway": {
    "tailscale": {
      "mode": "serve"  // chỉ truy cập được trong tailnet
    }
  }
}

Nếu muốn expose ra internet (public), đổi sang "mode": "funnel" và bắt buộc đặt password:

{
  "gateway": {
    "auth": { "mode": "password" },
    "tailscale": { "mode": "funnel" }
  }
}

Bảo mật cơ bản cho VPS

Khi chạy OpenClaw trên VPS, cần thêm một số biện pháp bảo mật:

1. Firewall (UFW):

sudo ufw allow ssh
sudo ufw enable

Không cần mở port 18789 ra ngoài — dùng SSH tunnel hoặc Tailscale thay vì expose trực tiếp.

2. Không chạy với root: Tạo user riêng cho OpenClaw:

sudo adduser openclaw
sudo usermod -aG sudo openclaw
su - openclaw
# Cài OpenClaw dưới user này (lặp lại Bước 1-5 Phần 1)

3. Tắt SSH password, dùng key only:

sudo nano /etc/ssh/sshd_config
# Đổi: PasswordAuthentication no
sudo systemctl restart sshd

4. Auto-update security patches:

sudo apt install -y unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades

---

Cấu hình nâng cao

File cấu hình

Tất cả cấu hình OpenClaw nằm tại ~/.openclaw/openclaw.json — định dạng JSON5 (hỗ trợ comment và trailing comma).

Mở bằng nano hoặc vim:

nano ~/.openclaw/openclaw.json

OpenClaw hỗ trợ hot reload — thay đổi config sẽ tự động áp dụng mà không cần restart daemon (mặc định gateway.reload.mode="hybrid").

Lưu ý: OpenClaw validate config chặt. Nếu config sai format, daemon sẽ không khởi động. Chạy openclaw doctor để kiểm tra config trước khi restart.

Quản lý daemon

# Xem trạng thái
systemctl --user status openclaw-gateway

# Restart daemon
systemctl --user restart openclaw-gateway

# Xem log real-time
journalctl --user -u openclaw-gateway -f

# Tắt daemon
systemctl --user stop openclaw-gateway

# Tắt tự khởi động
systemctl --user disable openclaw-gateway

Cập nhật OpenClaw

openclaw update

---

Cài trên Fedora / CentOS / RHEL

Quy trình gần giống Ubuntu, chỉ khác lệnh cài package:

Bước 1 (thay apt bằng dnf/yum):

# Fedora
sudo dnf update -y && sudo dnf install -y curl git gcc-c++ make

# CentOS / RHEL
sudo yum update -y && sudo yum install -y curl git gcc-c++ make

Bước 2-6: Giống hệt phần Ubuntu ở trên (nvm, openclaw install, onboard wizard, loginctl enable-linger).

Lưu ý CentOS 7: Nếu đang dùng CentOS 7, cần cài Node.js từ source hoặc dùng SCL vì glibc version quá cũ. Khuyến nghị nâng lên CentOS Stream 9 hoặc chuyển sang Ubuntu 22.04.

---

Cài trên Arch Linux

sudo pacman -Syu
sudo pacman -S curl git base-devel nodejs npm

Hoặc dùng nvm như Ubuntu. Từ bước cài OpenClaw trở đi, quy trình giống hệt.

---

Xử lý lỗi thường gặp trên Linux

Lỗi “EACCES: permission denied” khi cài npm global

Nếu không dùng nvm và cài npm global package bị lỗi quyền:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Rồi chạy lại lệnh cài OpenClaw.

Lỗi “openclaw: command not found”

PATH chưa nhận. Fix:

source ~/.bashrc

Hoặc đóng terminal mở lại. Nếu vẫn lỗi, kiểm tra: which openclaw hoặc ls ~/.nvm/versions/node/*/bin/openclaw.

OpenClaw crash sau một lúc (hết RAM trên VPS nhỏ)

VPS 1GB RAM có thể không đủ khi OpenClaw xử lý nhiều request. Thêm swap:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# Thêm vào fstab để tự mount khi reboot
echo '/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab

Lỗi node-gyp hoặc sharp

Thiếu build tools. Fix:

# Ubuntu/Debian
sudo apt install -y build-essential python3

# Fedora
sudo dnf install -y gcc-c++ make python3

systemd service không khởi động

Kiểm tra log chi tiết:

journalctl --user -u openclaw-gateway --no-pager -n 50

Nguyên nhân phổ biến: config file sai format, Node.js chưa cài, hoặc port 18789 bị chiếm. Chạy openclaw doctor để diagnostic.

Gặp lỗi khác? Xem danh sách đầy đủ 15+ lỗi tại Lỗi thường gặp khi cài OpenClaw.

---

Gỡ cài đặt

# Dừng và xóa daemon
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
rm ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

# Gỡ OpenClaw
npm uninstall -g openclaw

# Xóa dữ liệu cấu hình (cẩn thận — mất hết config)
rm -rf ~/.openclaw

---

Tự host Linux vs TryOpenClaw Cloud

Tiêu chí	Tự host trên VPS	TryOpenClaw.io
Chi phí	VPS ~$5-10/tháng + thời gian maintain	Từ 99K VND/tháng, bao gồm mọi thứ
Cập nhật	Chạy openclaw update thủ công	Tự động
Backup	Tự setup (cron + rsync hoặc snapshot)	Backup hàng ngày tự động
Bảo mật	Tự quản lý firewall, SSH, SSL	Managed — đội ngũ TryOpenClaw lo
Uptime	Phụ thuộc VPS provider + bạn	99.9% SLA
Phù hợp	DevOps, cần toàn quyền kiểm soát	Người muốn focus vào sử dụng

So sánh chi tiết: OpenClaw tự cài vs TryOpenClaw Cloud — nên chọn gì?

---

Tổng kết

Linux desktop (6 bước, ~10-15 phút):

1. Cập nhật hệ thống + cài build tools
2. Cài Node.js 24 (qua nvm)
3. Cài OpenClaw (curl hoặc npm install -g)
4. Chạy openclaw onboard --install-daemon
5. Bật loginctl enable-linger để daemon chạy sau logout
6. Truy cập http://localhost:18789

VPS Production (thêm ~15-20 phút):

1. Tối ưu khởi động (compile cache, no respawn)
2. SSH tunnel hoặc Tailscale cho truy cập từ xa
3. Bảo mật: firewall, tắt SSH password, user riêng
4. (Tùy chọn) Auto-update security patches

---

Bước tiếp theo: Cấu hình API Key OpenClaw — từ Claude đến GPT để tối ưu model cho workflow của bạn.

Hoặc: Đăng ký TryOpenClaw.io — bỏ qua toàn bộ cài đặt, dùng ngay trong 2 phút.

---