Chuyển đến nội dung chính

​
Raspberry Pi

Chạy OpenClaw Gateway liên tục trên Raspberry Pi. Vì Pi chỉ là gateway (các mô hình chạy trên đám mây qua API), nên ngay cả một Pi khiêm tốn cũng xử lý tốt khối lượng công việc.

​
Yêu cầu

  • Raspberry Pi 4 hoặc 5 với RAM 2 GB trở lên (khuyến nghị 4 GB)
  • Thẻ MicroSD (16 GB trở lên) hoặc USB SSD (hiệu suất tốt hơn)
  • Nguồn điện chính hãng cho Pi
  • Kết nối mạng (Ethernet hoặc WiFi)
  • Hệ điều hành Raspberry Pi 64-bit (bắt buộc — không dùng 32-bit)
  • Khoảng 30 phút

​
Thiết lập

1

Ghi hệ điều hành

Sử dụng Raspberry Pi OS Lite (64-bit) — không cần giao diện desktop cho server không màn hình.
  1. Tải Raspberry Pi Imager.
  2. Chọn hệ điều hành: Raspberry Pi OS Lite (64-bit).
  3. Trong hộp thoại cài đặt, cấu hình trước:
    • Hostname: gateway-host
    • Kích hoạt SSH
    • Đặt tên người dùng và mật khẩu
    • Cấu hình WiFi (nếu không dùng Ethernet)
  4. Ghi vào thẻ SD hoặc ổ USB, cắm vào và khởi động Pi.
2

Kết nối qua SSH

ssh user@gateway-host
3

Cập nhật hệ thống

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

# Đặt múi giờ (quan trọng cho cron và nhắc nhở)
sudo timedatectl set-timezone America/Chicago
4

Cài đặt Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Thêm swap (quan trọng cho 2 GB RAM hoặc ít hơn)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Giảm swappiness cho thiết bị ít RAM
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

Cài đặt OpenClaw

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

Chạy onboarding

openclaw onboard --install-daemon
Làm theo hướng dẫn. Khóa API được khuyến nghị hơn OAuth cho thiết bị không màn hình. Telegram là kênh dễ bắt đầu nhất.
8

Xác minh

openclaw status
sudo systemctl status openclaw
journalctl -u openclaw -f
9

Truy cập giao diện điều khiển

Trên máy tính, lấy URL dashboard từ Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Sau đó tạo một SSH tunnel trong terminal khác:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Mở URL đã in ra trong trình duyệt của bạn. Để truy cập từ xa liên tục, xem Tích hợp Tailscale.

​
Mẹo cải thiện hiệu suất

Sử dụng USB SSD — Thẻ SD chậm và dễ hỏng. USB SSD cải thiện hiệu suất đáng kể. Xem hướng dẫn boot USB cho Pi. Kích hoạt bộ nhớ đệm biên dịch module — Tăng tốc độ gọi CLI lặp lại trên Pi công suất thấp: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
Giảm sử dụng bộ nhớ — Đối với thiết lập không màn hình, giải phóng bộ nhớ GPU và vô hiệu hóa các dịch vụ không dùng: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

​
Khắc phục sự cố

Thiếu bộ nhớ — Kiểm tra swap có hoạt động không với free -h. Vô hiệu hóa các dịch vụ không dùng (sudo systemctl disable cups bluetooth avahi-daemon). Chỉ sử dụng các mô hình dựa trên API. Hiệu suất chậm — Sử dụng USB SSD thay vì thẻ SD. Kiểm tra CPU có bị giới hạn không với vcgencmd get_throttled (nên trả về 0x0). Dịch vụ không khởi động — Kiểm tra log với journalctl -u openclaw --no-pager -n 100 và chạy openclaw doctor --non-interactive. Vấn đề với binary ARM — Nếu một skill gặp lỗi “exec format error”, kiểm tra xem binary có bản build ARM64 không. Xác minh kiến trúc với uname -m (nên hiển thị aarch64). WiFi bị ngắt kết nối — Vô hiệu hóa quản lý năng lượng WiFi: sudo iwconfig wlan0 power off.

​
Bước tiếp theo

Last modified on March 22, 2026