HƯỚNG DẪN ĐẦY ĐỦ
Cài đặt OpenClaw
Cài đặt OpenClaw
trên Vultr VPS
Hướng dẫn từng bước triển khai AI Agent framework trên VPS Vultr — từ tạo server, cài đặt, cấu hình đến chạy 24/7 với PM2. Kèm script tự động cài đặt.
Yêu cầu VPS
- Ubuntu 22.04 / 24.04 LTS
- 1 vCPU, 1 GB RAM (tối thiểu)
- 25 GB SSD
- Vultr Cloud Compute
Cần chuẩn bị
- Tài khoản Vultr (có $100 free credit)
- API Key OpenAI hoặc Anthropic
- Telegram Bot Token
- Terminal (SSH client)
Kết quả đạt được
- AI Agent chạy 24/7 trên Vultr
- Kết nối Telegram Bot
- Tự động restart khi crash
- Skills: web search, weather, …
01
Tạo VPS trên Vultr
⏱️ ~3 phút
- Truy cập vultr.com → Đăng ký tài khoản (nhận $100 credit miễn phí)
- Click “Deploy +” → chọn Cloud Compute — Shared CPU
- Chọn location: Singapore hoặc Tokyo (gần Việt Nam nhất)
- Operating System: Ubuntu 22.04 LTS x64
- Plan: Regular Cloud Compute — $6/tháng (1 vCPU, 1GB RAM, 25GB SSD)
- Đặt hostname:
openclaw-agent - Click “Deploy Now” → đợi 1-2 phút để server khởi động
Mẹo: Nên chọn plan $12/tháng (2 vCPU, 2GB RAM) nếu dùng model GPT-4o
hoặc chạy nhiều skills cùng lúc. Plan $6 đủ cho GPT-4o-mini.
02
SSH vào server & cập nhật hệ thống
⏱️ ~2 phút
Sau khi server Running, lấy IP và mật khẩu root từ trang quản lý Vultr.
Terminal
# Kết nối SSH
ssh root@YOUR_SERVER_IP
# Cập nhật hệ thống
apt update && apt upgrade -y
# Cài đặt các gói cần thiết
apt install -y curl git build-essential ufw
⚠️ Bảo mật: Sau khi đăng nhập lần đầu, nên đổi mật khẩu root ngay bằng lệnh
passwd.
03
Cài đặt Node.js 20 LTS
⏱️ ~2 phút
OpenClaw yêu cầu Node.js 18+. Khuyến nghị dùng bản 20 LTS mới nhất.
Terminal
# Cài Node.js 20 LTS qua NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs
# Kiểm tra phiên bản
node --version # v20.x.x
npm --version # 10.x.x📤 Kết quả mong đợi
v20.18.2 10.9.2
04
Clone & cài đặt OpenClaw
⏱️ ~3 phút
Terminal
# Clone OpenClaw
cd /root
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Cài dependencies
npm install
# Tạo file cấu hình
cp .env.example .env
Script tự động: Bạn cũng có thể dùng script cài đặt 1 lệnh:
One-line Install
curl -fsSL https://khonggianai.com/scripts/install-openclaw.sh | bash
05
Cấu hình .env & Telegram Bot
⏱️ ~5 phút
5.1. Tạo Telegram Bot
- Mở Telegram → tìm
@BotFather - Gửi
/newbot→ đặt tên bot → nhận Bot Token - Tìm
@userinfobot→ gửi tin nhắn → lấy User ID của bạn
5.2. Cấu hình file .env
nano /root/openclaw/.env
# ===== LLM Provider (chọn 1) =====
OPENAI_API_KEY=sk-proj-your-openai-key-here
# ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
# ===== Telegram Bot =====
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNO...
ALLOWED_TELEGRAM_USERS=your_telegram_user_id
# ===== Agent Config =====
AGENT_NAME=MyAssistant
MODEL=gpt-4o-mini
MAX_TOKENS=4096
# ===== Gateway (bảo mật) =====
GATEWAY_AUTH_TOKEN=your-secret-token-here
# ===== Tùy chọn =====
LOG_LEVEL=info
TIMEZONE=Asia/Ho_Chi_Minh
⚠️ Quan trọng: Luôn set
ALLOWED_TELEGRAM_USERS để chỉ bạn mới
chat được với bot. Nếu bỏ trống, ai cũng chat được → tốn API key.
5.3. Cấu hình Telegram nâng cao
config/telegram.json
{
"platform": "telegram",
"allowed_users": [123456789],
"features": {
"voice_messages": true,
"image_analysis": true,
"inline_mode": false
},
"rate_limit": {
"messages_per_minute": 20,
"daily_limit": 500
}
}
06
Chạy thử & kiểm tra
⏱️ ~2 phút
Terminal
cd /root/openclaw
npm run dev📤 Kết quả mong đợi
[OpenClaw] Starting agent "MyAssistant"... [OpenClaw] LLM: OpenAI gpt-4o-mini connected ✓ [OpenClaw] Telegram bot connected ✓ [OpenClaw] Skills loaded: web_search, calculator, weather [OpenClaw] Gateway listening on port 3000 ✓ [OpenClaw] Listening for messages...
Mở Telegram → tìm bot của bạn → gửi thử:
Thời tiết Hà Nội hôm nay thế nào?
Đang tìm kiếm…
🌤️ Thời tiết Hà Nội hôm nay:
• Nhiệt độ: 24°C, trời nhiều mây
• Độ ẩm: 78%
• Gió: 12 km/h hướng Đông Nam
• Dự báo: Chiều có thể mưa nhẹ
📅 Nguồn: OpenWeatherMap
🌤️ Thời tiết Hà Nội hôm nay:
• Nhiệt độ: 24°C, trời nhiều mây
• Độ ẩm: 78%
• Gió: 12 km/h hướng Đông Nam
• Dự báo: Chiều có thể mưa nhẹ
📅 Nguồn: OpenWeatherMap
Nếu gặp lỗi: Kiểm tra
TELEGRAM_BOT_TOKEN đúng chưa,
OPENAI_API_KEY đã tạo và có credit chưa. Xem log chi tiết bằng
LOG_LEVEL=debug npm run dev.
07
Chạy 24/7 với PM2
⏱️ ~2 phút
PM2 là process manager giúp app chạy liên tục, tự restart khi crash, và tự khởi động khi server reboot.
Terminal
# Cài PM2
npm install -g pm2
# Chạy OpenClaw với PM2
cd /root/openclaw
pm2 start npm --name "openclaw" -- run start
# Xem status
pm2 status
# Xem log real-time
pm2 logs openclaw
# Tự khởi động khi server reboot
pm2 startup
pm2 save📤 pm2 status
┌─────┬──────────┬────┬──────┬────────┬─────────┬────────┐ │ id │ name │mode│ ↺ │ status │ cpu │ memory │ ├─────┼──────────┼────┼──────┼────────┼─────────┼────────┤ │ 0 │ openclaw │fork│ 0 │ online │ 0.3% │ 95 MB │ └─────┴──────────┴────┴──────┴────────┴─────────┴────────┘
Các lệnh PM2 thường dùng
| Lệnh | Mô tả |
|---|---|
pm2 restart openclaw |
Restart agent |
pm2 stop openclaw |
Dừng agent |
pm2 logs openclaw --lines 50 |
Xem 50 dòng log cuối |
pm2 monit |
Monitor CPU/RAM real-time |
pm2 delete openclaw |
Xóa process |
08
Bảo mật & Tối ưu
⏱️ ~3 phút
8.1. Bật Firewall (UFW)
Terminal
# Cho phép SSH và gateway
ufw allow 22/tcp
ufw allow 3000/tcp
ufw enable
# Kiểm tra
ufw status8.2. Tạo user riêng (không dùng root)
Terminal
# Tạo user mới
adduser openclaw
usermod -aG sudo openclaw
# Chuyển sang user mới
su - openclaw
# Di chuyển project
sudo mv /root/openclaw /home/openclaw/
sudo chown -R openclaw:openclaw /home/openclaw/openclaw8.3. Tối ưu chi phí API
🔄 Dùng model phù hợp
GPT-4o-mini cho task đơn giản (rẻ hơn ~20x), GPT-4o cho task phức tạp
📏 Giới hạn history
Set MAX_HISTORY=20 để tránh gửi quá nhiều token
⏱️ Rate limiting
Set rate_limit trong config để tránh spam
📊 Monitor chi phí
Kiểm tra usage tại platform.openai.com/usage hàng tuần
🔧 Xử lý lỗi thường gặp
❌
ERR_MODULE_NOT_FOUND: undici
Fix:
npm install undici — Module bị thiếu khi dùng Zalo plugin.
❌
GATEWAY_AUTH_TOKEN is required
Fix: Thêm
GATEWAY_AUTH_TOKEN=any-secret-string vào file .env
❌
Telegram: 401 Unauthorized
Fix: Bot token sai hoặc bot bị xóa. Tạo lại bot trên @BotFather.
❌
OpenAI: 429 Rate limit exceeded
Fix: Hết credit hoặc gửi quá nhiều request. Kiểm tra billing tại
platform.openai.com.
❌ PM2 process keeps restarting
Fix: Xem log:
pm2 logs openclaw --lines 100. Thường do thiếu biến
.env hoặc lỗi cú pháp config.
🏗️ Kiến trúc hệ thống
OpenClaw Architecture
┌─────────────────────────────────────────┐
│ Messaging Platforms │
│ Telegram │ Discord │ Slack │ WhatsApp │
└──────────────────┬──────────────────────┘
│ messages
┌──────▼──────┐
│ OpenClaw │
│ ┌─────────┐ │
│ │ LLM │ │ ← GPT-4o, Claude, Gemini, Ollama
│ │ Engine │ │
│ ├─────────┤ │
│ │ Memory │ │ ← Conversation history
│ ├─────────┤ │
│ │ Skills │ │ ← Web search, weather, email
│ ├─────────┤ │
│ │ Gateway │ │ ← REST API, Auth
│ └─────────┘ │
└─────────────┘
│
┌────────┼────────┐
▼ ▼ ▼
Web APIs Database Files🚀 Bước tiếp theo
Download hướng dẫn đầy đủ
Tải bản hướng dẫn chi tiết dưới dạng Google Docs — có thể in, tải về DOCX/PDF, hoặc đọc offline.