🚀

Chương 2: Cài Đặt OpenClaw

Cơ Bản⏱ 10 phút đọc

⚠️ Yêu cầu: máy tính có kết nối internet, 2GB RAM trống, và một API key từ nhà cung cấp AI (OpenAI, Google, Anthropic...).

2.1 Cài trên macOS

Cách nhanh nhất — dùng Homebrew:

Homebrew

brew tap nicepkg/tap
brew install openclaw

Hoặc tải file .dmg từ trang chủ:

Tải trực tiếp

# Truy cập: https://github.com/nicepkg/openclaw/releases
# Tải file .dmg mới nhất
# Mở file → kéo OpenClaw vào Applications

2.2 Cài trên Windows

winget

winget install nicepkg.openclaw

Hoặc dùng Scoop:

Scoop

scoop bucket add extras
scoop install openclaw

Hoặc tải .exe installer từ GitHub Releases.

2.3 Cài trên Linux

curl

curl -fsSL https://raw.githubusercontent.com/nicepkg/openclaw/main/install.sh | bash

Hoặc dùng npm (cần Node.js 18+):

npm

npm install -g openclaw

2.4 Cài bằng Docker

Phù hợp cho server hoặc ai muốn cô lập:

Docker

docker pull nicepkg/openclaw:latest
docker run -d --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  nicepkg/openclaw:latest

2.5 Kiểm tra cài đặt

Kiểm tra

openclaw --version
# → OpenClaw v1.x.x

openclaw doctor
# → Kiểm tra tất cả dependencies

2.6 Cấu hình API Key

OpenClaw cần ít nhất 1 API key để kết nối model AI. Bạn có thể lấy từ:

• OpenAI — platform.openai.com → Rẻ, nhanh, phổ biến nhất
• Google Gemini — ai.google.dev → Có tier miễn phí
• Anthropic Claude — console.anthropic.com → Thông minh nhất
• DeepSeek — platform.deepseek.com → Rẻ nhất, tốt cho tiếng Việt

Thêm API key

openclaw config set api_key YOUR_API_KEY_HERE

# Hoặc chỉnh file cấu hình:
openclaw config edit

💡 Mẹo cho người Việt: DeepSeek là lựa chọn rẻ nhất (~$0.14/1M tokens) và hiểu tiếng Việt khá tốt. Google Gemini có tier miễn phí nếu bạn muốn thử trước.

2.7 Onboard Wizard — Cài đặt có hướng dẫn

Nếu bạn mới hoàn toàn, chạy wizard để được dẫn từng bước:

Onboard Wizard

openclaw onboard --install-daemon

# Wizard sẽ hỏi bạn:
# 1. Chọn AI provider (Anthropic/OpenAI/Google...)
# 2. Paste API key
# 3. Chọn kênh chat (Telegram/Discord/Web)
# 4. Đặt tên cho trợ lý
# → Xong! Chạy lệnh bên dưới để bắt đầu

Khởi động

openclaw dashboard
# Mở trình duyệt → http://localhost:3000

2.8 Cài bằng Docker Compose (nâng cao)

Dùng Docker Compose để quản lý dễ hơn, đặc biệt khi chạy trên server:

docker-compose.yml

version: "3.8"
services:
  openclaw:
    image: nicepkg/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3000:3000"    # Dashboard
      - "18789:18789"  # Gateway
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - TZ=Asia/Ho_Chi_Minh
      - OPENCLAW_API_KEY=${OPENCLAW_API_KEY}
    healthcheck:
      test: ["CMD", "openclaw", "doctor", "--quick"]
      interval: 60s
      timeout: 10s
      retries: 3

Chạy

# Tạo file .env cùng thư mục
echo "OPENCLAW_API_KEY=sk-your-key-here" > .env

# Khởi động
docker compose up -d

# Xem logs
docker compose logs -f openclaw

2.9 Xử Lý Lỗi Cài Đặt Thường Gặp

Lỗi	Nguyên nhân	Cách sửa
EACCES permission denied	Không có quyền ghi	Dùng sudo hoặc --prefix
node: command not found	Chưa cài Node.js	Cài Node.js 22+
Port 18789 already in use	Đang chạy instance khác	lsof -i :18789 → kill PID
API key invalid	Key sai hoặc hết hạn	Kiểm tra lại key từ provider
Gateway auth error	Chưa set auth mode (v2026.3.7+)	openclaw config set gateway.auth.mode token

Sửa nhanh — chạy doctor

openclaw doctor --deep --yes
# Tự động phát hiện và sửa hầu hết lỗi

2.10 Cài trên Android (Termux)

Bạn có thể chạy OpenClaw ngay trên điện thoại Android — miễn phí, không cần máy tính:

Bước 1: Cài Termux

# Tải Termux từ F-Droid (KHÔNG dùng Google Play)
# https://f-droid.org/packages/com.termux/

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

pkg update && pkg upgrade
pkg install nodejs-lts
npm i -g openclaw
openclaw onboard

⚠️ Termux chạy chậm hơn máy tính. Nên dùng model nhẹ (DeepSeek, Gemini Flash).

2.11 Deploy lên Cloud (VPS / Railway / Render)

Muốn OpenClaw chạy 24/7 không cần bật máy? Deploy lên cloud:

Cách 1: VPS (khuyên dùng)

# Thuê VPS từ $3-5/tháng (DigitalOcean, Linode, Vultr)
# SSH vào server:
ssh root@your-server-ip

# Cài đặt
curl -fsSL https://raw.githubusercontent.com/nicepkg/openclaw/main/install.sh | bash
openclaw onboard --install-daemon

# Chạy nền (daemon)
openclaw gateway start --daemon

Cách 2: Railway (1-click)

# Truy cập railway.app → New Project → Deploy from GitHub
# Chọn repo: nicepkg/openclaw
# Thêm biến môi trường: OPENCLAW_API_KEY
# → Tự động deploy, có SSL, miễn phí $5/tháng

2.12 Chọn Model AI nào cho lần đầu?

Lần đầu dùng OpenClaw? Đây là gợi ý theo ngân sách:

Ngân sách	Model khuyên dùng	Chi phí
Miễn phí	Gemini 2.0 Flash	$0 (1500 req/ngày)
Tiết kiệm	DeepSeek V3	~$1-3/tháng
Cân bằng	GPT-4o mini	~$3-8/tháng
Chất lượng cao	Claude Sonnet 4	~$5-15/tháng
Local (offline)	Ollama + Llama 3	$0 (cần GPU 8GB+)

Setup model đầu tiên

# Ví dụ: dùng DeepSeek (rẻ, tiếng Việt tốt)
openclaw config set models.primary.provider deepseek
openclaw config set models.primary.apiKey sk-your-deepseek-key
openclaw config set models.primary.model deepseek-chat

# Kiểm tra kết nối
openclaw doctor --check-models

2.13 Lấy API Key — Hướng dẫn từng provider

Anthropic (Claude)

1. Truy cập console.anthropic.com
2. Đăng ký / Đăng nhập → API Keys → Create Key
3. Copy key (bắt đầu bằng sk-ant-...)

OpenAI (GPT)

1. Truy cập platform.openai.com
2. API Keys → Create new secret key
3. Copy key (bắt đầu bằng sk-...)

Google (Gemini)

1. Truy cập aistudio.google.com
2. Get API Key → Create API key
3. Free tier: 1500 requests/ngày!

DeepSeek

1. Truy cập platform.deepseek.com
2. Đăng ký → API Keys → Create
3. Nạp $5 dùng được vài tháng!

OpenRouter (1 key = 100+ models)

1. Truy cập openrouter.ai
2. Keys → Create Key
3. 1 API key dùng được Claude, GPT, Gemini, DeepSeek...

🚨 Lỗi thường gặp: Nếu thấy 'command not found', hãy đóng terminal và mở lại, hoặc thêm OpenClaw vào PATH. Chạy 'openclaw doctor' để kiểm tra.

←

Chương 1

OpenClaw là gì?

Chương 3

Gửi tin nhắn đầu tiên

→