🤖 Hướng Dẫn Cài Đặt OpenClaw Từ Đầu Trên Ubuntu Desktop

💡 Dành cho ai: Người mới bắt đầu, muốn có AI assistant riêng trên máy Ubuntu Desktop, sử dụng ClipProxy để tiết kiệm chi phí.

📚 Mục Lục

🌟 Giới Thiệu
📋 Yêu Cầu Hệ Thống
🔑 Chuẩn Bị ClipProxy Token
⚙️ Cài Đặt OpenClaw
🔧 Cấu Hình ClipProxy
📱 Kết Nối Telegram Bot
✅ Kiểm Tra & Test
🚀 Khởi Động Tự Động
🆘 Xử Lý Lỗi Thường Gặp

🌟 Giới Thiệu

🎯 OpenClaw Là Gì?

OpenClaw là một AI gateway mã nguồn mở cho phép bạn:

🤖 Tương tác với nhiều AI models (Claude, GPT, Gemini)
💬 Qua Telegram bot
🔧 Chạy scripts & automation
📊 Quản lý files
🌐 Browse web
💻 Execute code

🔵 Tại Sao Dùng ClipProxy?

Tính Năng	ClipProxy	Direct API
🔑 Số API key	1	Nhiều (3-5)
💰 Chi phí	Rẻ hơn	Đắt hơn
🎯 Số models	50+	1-3
⚡ Setup	Dễ	Phức tạp
🆓 Free tier	✅ Có	❌ Hạn chế

📋 Yêu Cầu Hệ Thống

💻 Phần Cứng Tối Thiểu

Thành Phần	Tối Thiểu	Khuyến Nghị
🖥️ CPU	2 cores	4 cores
💾 RAM	2GB	4GB+
💿 Disk	10GB free	20GB+
🌐 Internet	Stable	Fiber/4G

🐧 Hệ Điều Hành

✅ Ubuntu Desktop 20.04+ (khuyến nghị)
✅ Ubuntu Desktop 22.04 LTS
✅ Ubuntu Desktop 24.04 LTS
⚠️ Các distro khác (Debian, Mint) cũng OK

🔍 Kiểm Tra Phiên Bản

# Check Ubuntu version
lsb_release -a

# Check CPU
lscpu | grep "Model name"

# Check RAM
free -h

# Check disk
df -h /

🔑 Chuẩn Bị ClipProxy Token

Bước 1: Đăng Ký ClipProxy

🌐 Truy cập: (URL ClipProxy dashboard của bạn)
📧 Đăng ký tài khoản (email + password)
✅ Verify email (check inbox/spam)

Bước 2: Lấy API Token

🔐 Đăng nhập dashboard
⚙️ Click Settings → API Keys
➕ Click Create New Key
📝 Đặt tên: OpenClaw Desktop
📋 Copy token (chỉ hiện 1 lần!)

⚠️ Lưu token vào file an toàn:

# Tạo file lưu token
echo "CLIPROXY_TOKEN=your_token_here" > ~/cliproxy-token.txt
chmod 600 ~/cliproxy-token.txt

Bước 3: Test Token

# Load token
source ~/cliproxy-token.txt

# Test API
curl -H "Authorization: Bearer $CLIPROXY_TOKEN" \
  https://api.clipproxy.com/v1/models | jq '.data[0]'

✅ Kết quả thành công:

{
  "id": "cliproxy/claude-sonnet-4-5-20250929",
  "object": "model",
  "created": 1234567890,
  "owned_by": "clipproxy"
}

⚙️ Cài Đặt OpenClaw

Bước 1: Cập Nhật Hệ Thống

# 🔄 Update package list
sudo apt update

# ⬆️ Upgrade packages
sudo apt upgrade -y

# 🧹 Cleanup
sudo apt autoremove -y

Bước 2: Cài Dependencies

# 📦 Cài các packages cần thiết
sudo apt install -y \
  curl \
  wget \
  git \
  jq \
  build-essential \
  ca-certificates

# ✅ Verify
curl --version
git --version
jq --version

Bước 3: Download OpenClaw

# 📂 Tạo thư mục
mkdir -p ~/openclaw
cd ~/openclaw

# 📥 Download (chọn 1 trong 2 cách)

# Cách 1: Từ GitHub releases
wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw-linux-amd64.tar.gz
tar -xzf openclaw-linux-amd64.tar.gz

# Cách 2: Clone repo (nếu muốn build từ source)
# git clone https://github.com/openclaw/openclaw.git
# cd openclaw && make build

Bước 4: Verify Installation

# ✅ Check binary
./openclaw-gateway --version

# Kết quả:
# OpenClaw Gateway v0.9.5

🔧 Cấu Hình ClipProxy

Bước 1: Tạo Config File

# 📝 Tạo thư mục config
mkdir -p ~/.openclaw

# ✏️ Tạo file config
nano ~/.openclaw/config.yaml

Bước 2: Config Cơ Bản (ClipProxy)

Paste nội dung sau:

# 🔧 OpenClaw Configuration
# =====================================

# 🌐 Provider: ClipProxy
providers:
  - kind: openai  # ClipProxy dùng OpenAI-compatible API
    name: cliproxy-main
    apiKey: ${CLIPROXY_TOKEN}  # Sẽ load từ env
    baseUrl: https://api.clipproxy.com/v1
    
    # 📊 Models
    models:
      - cliproxy/claude-sonnet-4-5-20250929    # ⚡ Cân bằng
      - cliproxy/claude-haiku-4                # 🏃 Nhanh, rẻ
      - cliproxy/gemini-2-flash                # 📚 Context dài
    
    # ⏱️ Rate limits
    rateLimits:
      requestsPerMinute: 60
      tokensPerMinute: 100000
    
    # ⏳ Timeout
    timeout: 60s

# 🤖 Agent Configuration
agents:
  - id: default
    name: Main Assistant
    model: cliproxy/claude-sonnet-4-5-20250929
    
    # 💬 System prompt
    systemPrompt: |
      You are a helpful AI assistant.
      You can help with coding, research, and general tasks.
      Always be accurate and concise.
    
    # ⚙️ Settings
    maxTokens: 4096
    temperature: 0.7
    
    # 🧠 Memory
    memory:
      enabled: true
      maxMessages: 50

# 🌐 Server Settings
server:
  host: 0.0.0.0
  port: 28080
  maxConcurrentSessions: 5
  requestTimeoutSeconds: 120

# 📊 Logging
logging:
  level: info
  outputs:
    - type: file
      path: logs/gateway.log
      maxSizeMB: 50
      maxBackups: 5
    - type: stdout
      colorize: true

💾 Lưu file: – Nhấn Ctrl+X – Nhấn Y – Nhấn Enter

Bước 3: Load ClipProxy Token

# 🔐 Thêm token vào environment
echo 'export CLIPROXY_TOKEN="your_token_here"' >> ~/.bashrc

# Hoặc load từ file
echo 'source ~/cliproxy-token.txt' >> ~/.bashrc

# 🔄 Reload
source ~/.bashrc

# ✅ Verify
echo $CLIPROXY_TOKEN

Bước 4: Validate Config

# 📝 Check YAML syntax
cat ~/.openclaw/config.yaml | grep -v '^#' | grep -v '^$'

# Hoặc dùng yamllint (nếu có)
# sudo apt install yamllint
# yamllint ~/.openclaw/config.yaml

📱 Kết Nối Telegram Bot

Bước 1: Tạo Bot

💬 Mở Telegram, tìm @BotFather
📤 Gửi /newbot
📝 Đặt tên bot: My OpenClaw Bot
🔖 Đặt username: myopenclaw_bot (phải unique)
📋 Copy token (dạng 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Bước 2: Lấy Chat ID

# 1️⃣ Start bot trong Telegram (click Start)

# 2️⃣ Lấy chat ID
curl -s "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates" | jq '.result[0].message.chat.id'

# Kết quả: 123456789

Bước 3: Thêm Telegram Config

# ✏️ Edit config
nano ~/.openclaw/config.yaml

Thêm vào cuối file:

# 📱 Telegram Integration
telegram:
  enabled: true
  token: ${TELEGRAM_BOT_TOKEN}  # Load từ env
  
  # 🔐 Allowed users (chat IDs)
  allowedUsers:
    - 123456789  # Your chat ID
  
  # ✨ Features
  features:
    voiceMessages: true
    imageAnalysis: true
    documentAnalysis: true
  
  # 🔔 Notifications
  notifications:
    startup: true
    errors: true

💾 Lưu và thêm token vào env:

# 🔑 Add Telegram token
echo 'export TELEGRAM_BOT_TOKEN="123456789:ABCdef..."' >> ~/.bashrc
source ~/.bashrc

✅ Kiểm Tra & Test

Bước 1: Khởi Động Gateway

# 🚀 Start OpenClaw
cd ~/openclaw
./openclaw-gateway serve

✅ Output thành công:

2026-03-12 07:30:00 INFO  OpenClaw Gateway v0.9.5
2026-03-12 07:30:01 INFO  Loading config from ~/.openclaw/config.yaml
2026-03-12 07:30:02 INFO  Connected to ClipProxy
2026-03-12 07:30:03 INFO  Telegram bot started: @myopenclaw_bot
2026-03-12 07:30:04 INFO  Gateway listening on 0.0.0.0:28080
2026-03-12 07:30:05 INFO  ✅ Ready to serve requests

Bước 2: Test Qua Telegram

📱 Mở Telegram bot
💬 Gửi tin nhắn: Xin chào
✅ Bot trả lời → Thành công!

Test nâng cao:

Bạn: /status
Bot: 📊 OpenClaw Status
     ✅ Gateway: Running
     🔵 Provider: ClipProxy
     📊 Model: claude-sonnet-4-5
     ⏱️ Uptime: 2m 15s

Bạn: Tính 2+2
Bot: 2 + 2 = 4

Bạn: Viết code Python in Hello World
Bot: ```python
print("Hello World")


### Bước 3: Test Qua curl

```bash
# 🧪 Test health endpoint
curl http://localhost:28080/health

# Kết quả:
# {"status":"ok","version":"0.9.5"}

# 🧪 Test chat completion
curl -X POST http://localhost:28080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cliproxy/claude-sonnet-4-5-20250929",
    "messages": [{"role": "user", "content": "Say hello"}]
  }'

🚀 Khởi Động Tự Động

Option 1: Systemd Service (Khuyến nghị)

# 📝 Tạo service file
sudo nano /etc/systemd/system/openclaw.service

Nội dung:

[Unit]
Description=🤖 OpenClaw AI Gateway
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME/openclaw
Environment="CLIPROXY_TOKEN=your_token_here"
Environment="TELEGRAM_BOT_TOKEN=your_bot_token_here"
ExecStart=/home/YOUR_USERNAME/openclaw/openclaw-gateway serve
Restart=always
RestartSec=10

# Logs
StandardOutput=append:/home/YOUR_USERNAME/openclaw/logs/gateway.log
StandardError=append:/home/YOUR_USERNAME/openclaw/logs/error.log

# Limits
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

🔄 Kích hoạt:

# Reload systemd
sudo systemctl daemon-reload

# Enable auto-start
sudo systemctl enable openclaw

# Start service
sudo systemctl start openclaw

# Check status
sudo systemctl status openclaw

# View logs
sudo journalctl -u openclaw -f

Option 2: Startup Script (Desktop)

# 📝 Tạo script
nano ~/.config/autostart/openclaw.desktop

Nội dung:

[Desktop Entry]
Type=Application
Name=OpenClaw Gateway
Exec=/home/YOUR_USERNAME/openclaw/start.sh
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true

Tạo start script:

# 📝 Create start.sh
cat > ~/openclaw/start.sh << 'EOF'
#!/bin/bash
cd ~/openclaw
source ~/.bashrc
./openclaw-gateway serve >> logs/startup.log 2>&1 &
EOF

# 🔐 Make executable
chmod +x ~/openclaw/start.sh

🆘 Xử Lý Lỗi Thường Gặp

❌ Lỗi 1: “Cannot connect to ClipProxy”

Nguyên nhân: Token sai hoặc internet issue

Cách sửa:

# 1️⃣ Check internet
ping -c 3 google.com

# 2️⃣ Test ClipProxy API
curl https://api.clipproxy.com/v1/models

# 3️⃣ Verify token
echo $CLIPROXY_TOKEN

# 4️⃣ Test với token
curl -H "Authorization: Bearer $CLIPROXY_TOKEN" \
  https://api.clipproxy.com/v1/models

❌ Lỗi 2: “Port 28080 already in use”

Cách sửa:

# 🔍 Tìm process
sudo lsof -i :28080

# 💥 Kill process
sudo kill -9 <PID>

# 🚀 Restart OpenClaw
./openclaw-gateway serve

❌ Lỗi 3: “Telegram bot not responding”

Check list:

# ✅ Bot token đúng?
echo $TELEGRAM_BOT_TOKEN

# ✅ Bot đã start trong Telegram chưa?
# → Click Start button trong chat

# ✅ Chat ID đúng chưa?
curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getUpdates" | jq

# ✅ Gateway có chạy không?
curl http://localhost:28080/health

❌ Lỗi 4: “Config YAML syntax error”

Cách sửa:

# 🔍 Check syntax
cat ~/.openclaw/config.yaml | python3 -c 'import yaml,sys; yaml.safe_load(sys.stdin)'

# Hoặc online
# Copy config → paste vào https://www.yamllint.com/

# 📝 Common issues:
# - Dùng tabs thay vì spaces
# - Indentation không đều
# - Thiếu dấu : hoặc -

❌ Lỗi 5: “Out of memory”

Cách sửa:

# 📊 Check memory
free -h

# 🔧 Giảm max sessions trong config
nano ~/.openclaw/config.yaml

# Sửa:
server:
  maxConcurrentSessions: 3  # Giảm từ 5

# 💾 Hoặc tăng swap
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

🎓 Quick Reference

🔧 Lệnh Thường Dùng

# 🚀 Start Gateway
cd ~/openclaw && ./openclaw-gateway serve

# 🛑 Stop Gateway
pkill openclaw-gateway

# 🔄 Restart
pkill openclaw-gateway && ./openclaw-gateway serve &

# 📜 View logs
tail -f ~/openclaw/logs/gateway.log

# ✅ Check status
curl http://localhost:28080/health

# 🔧 Edit config
nano ~/.openclaw/config.yaml

# 📊 System check
systemctl status openclaw

📁 File Locations

File	Location
📝 Config	`~/.openclaw/config.yaml`
📜 Logs	`~/openclaw/logs/gateway.log`
🔑 Tokens	`~/cliproxy-token.txt`
💾 Data	`~/.openclaw/data/`
⚙️ Binary	`~/openclaw/openclaw-gateway`

🔗 Links Hữu Ích

Resource	URL
📚 OpenClaw Docs	https://github.com/openclaw/openclaw
🔵 ClipProxy Dashboard	(Your dashboard URL)
💬 Telegram BotFather	https://t.me/BotFather
🔍 YAML Validator	https://www.yamllint.com/

✅ Checklist Hoàn Thành

🎉 Kết Luận

Chúc mừng! 🎊 Bạn đã cài đặt thành công OpenClaw trên Ubuntu Desktop với ClipProxy.

🚀 Next Steps:

📚 Đọc thêm: Tối Ưu Hiệu Năng OpenClaw
🔐 Tìm hiểu: Bảo Mật OpenClaw Production
📊 Setup: Monitoring & Logging
💬 Join: Telegram community

💡 Tips:

🔄 Backup config thường xuyên
📊 Monitor token usage trên ClipProxy dashboard
🔧 Update OpenClaw khi có version mới
📝 Đọc changelog trước khi update

📧 Support: – Email: namvuhvq@gmail.com – Telegram: @namvuhvq – Blog: https://blog.namvuhvqy.io.vn

📅 Version: 1.0 | Last updated: 2026-03-12

⭐ Nếu bài viết hữu ích, hãy share cho bạn bè!

🤖 Hướng Dẫn Cài Đặt OpenClaw Từ Đầu Trên Ubuntu Desktop

📚 Mục Lục

🌟 Giới Thiệu

🎯 OpenClaw Là Gì?

🔵 Tại Sao Dùng ClipProxy?

📋 Yêu Cầu Hệ Thống

💻 Phần Cứng Tối Thiểu

🐧 Hệ Điều Hành

🔍 Kiểm Tra Phiên Bản

🔑 Chuẩn Bị ClipProxy Token

Bước 1: Đăng Ký ClipProxy

Bước 2: Lấy API Token

Bước 3: Test Token

⚙️ Cài Đặt OpenClaw

Bước 1: Cập Nhật Hệ Thống

Bước 2: Cài Dependencies

Bước 3: Download OpenClaw

Bước 4: Verify Installation

🔧 Cấu Hình ClipProxy

Bước 1: Tạo Config File

Bước 2: Config Cơ Bản (ClipProxy)

Bước 3: Load ClipProxy Token

Bước 4: Validate Config

📱 Kết Nối Telegram Bot

Bước 1: Tạo Bot

Bước 2: Lấy Chat ID

Bước 3: Thêm Telegram Config

✅ Kiểm Tra & Test

Bước 1: Khởi Động Gateway

Bước 2: Test Qua Telegram

🚀 Khởi Động Tự Động

Option 1: Systemd Service (Khuyến nghị)

Option 2: Startup Script (Desktop)

🆘 Xử Lý Lỗi Thường Gặp

❌ Lỗi 1: “Cannot connect to ClipProxy”

❌ Lỗi 2: “Port 28080 already in use”

❌ Lỗi 3: “Telegram bot not responding”

❌ Lỗi 4: “Config YAML syntax error”

❌ Lỗi 5: “Out of memory”

🎓 Quick Reference

🔧 Lệnh Thường Dùng

📁 File Locations

🔗 Links Hữu Ích

✅ Checklist Hoàn Thành

🎉 Kết Luận

🚀 Next Steps:

💡 Tips:

Để lại một bình luận Huỷ trả lời