Raspberry Pi

Chạy Gateway OpenClaw liên tục, luôn bật trên Raspberry Pi. Vì Pi chỉ đóng vai trò là Gateway (các mô hình chạy trên đám mây qua API), ngay cả một chiếc Pi cấu hình vừa phải cũng xử lý tốt khối lượng công việc — chi phí phần cứng thông thường là 35–80 USD trả một lần, không có phí hằng tháng.

Khả năng tương thích phần cứng

Tối thiểu: RAM 1 GB, 1 lõi, 500 MB dung lượng đĩa trống, hệ điều hành 64 bit. Khuyến nghị: RAM từ 2 GB, thẻ SD từ 16 GB (hoặc SSD USB), Ethernet.

Điều kiện tiên quyết

• Raspberry Pi 4 hoặc 5 với RAM từ 2 GB (khuyến nghị 4 GB)
• Thẻ MicroSD (từ 16 GB) hoặc SSD USB (hiệu năng tốt hơn)
• Bộ nguồn Pi chính hãng
• Kết nối mạng (Ethernet hoặc WiFi)
• Raspberry Pi OS 64 bit (bắt buộc — không sử dụng bản 32 bit)
• Khoảng 30 phút

Thiết lập

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Đặt múi giờ (quan trọng đối với cron và lời nhắc)sudo timedatectl set-timezone America/Chicago

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

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Giảm mức sử dụng swap cho thiết bị có ít RAMecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

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

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

Mẹo cải thiện hiệu năng

Sử dụng SSD USB — thẻ SD chậm và bị hao mòn. SSD USB cải thiện đáng kể hiệu năng và chịu được nhiều chu kỳ ghi hơn; hãy sử dụng ổ này cho OPENCLAW_STATE_DIR nếu bạn vẫn giữ hệ điều hành trên thẻ SD. Xem hướng dẫn khởi động Pi qua USB.

Bật bộ nhớ đệm biên dịch mô-đun — tăng tốc các lần gọi CLI lặp lại trên máy chủ Pi có công suất thấp. OPENCLAW_NO_RESPAWN=1 giữ các lần khởi động lại Gateway thông thường trong cùng tiến trình, tránh việc chuyển giao giữa các tiến trình và giúp việc theo dõi PID đơn giản hơn trên các máy chủ nhỏ:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

Sử dụng /var/tmp, không dùng /tmp — một số bản phân phối xóa /tmp khi khởi động, khiến bộ nhớ đệm đã được làm nóng bị mất.

Giảm mức sử dụng bộ nhớ — đối với cấu hình không màn hình, hãy giải phóng bộ nhớ GPU và tắt các dịch vụ không sử dụng:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txtsudo systemctl disable bluetooth

Cấu hình bổ sung systemd để khởi động lại ổn định — nếu Pi này chủ yếu chạy OpenClaw, hãy thêm cấu hình bổ sung cho dịch vụ:

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

Sau đó chạy systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Trên Pi không màn hình, cũng cần bật chế độ duy trì một lần để dịch vụ người dùng tiếp tục chạy sau khi đăng xuất: sudo loginctl enable-linger "$(whoami)".

Thiết lập mô hình được khuyến nghị

Vì Pi chỉ chạy Gateway, hãy sử dụng các mô hình API được lưu trữ trên đám mây — không chạy LLM cục bộ trên Pi, vì ngay cả các mô hình nhỏ cũng quá chậm để sử dụng hiệu quả:

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet-4-6",        "fallbacks": ["openai/gpt-5.4-mini"]      }    }  }}

Lưu ý về tệp nhị phân ARM

Hầu hết tính năng của OpenClaw hoạt động trên ARM64 mà không cần thay đổi (Node.js, Telegram, WhatsApp/Baileys, Chromium). Các tệp nhị phân đôi khi không có bản dựng ARM thường là những công cụ CLI Go/Rust tùy chọn được cung cấp bởi Skills. Xác minh kiến trúc bằng uname -m (kết quả phải là aarch64), sau đó kiểm tra trang phát hành của tệp nhị phân còn thiếu để tìm các bản dựng linux-arm64 / aarch64 trước khi chuyển sang tự xây dựng từ mã nguồn.

Duy trì dữ liệu và sao lưu

Trạng thái OpenClaw được lưu tại:

• ~/.openclaw/ — openclaw.json, auth-profiles.json cho từng tác nhân, trạng thái kênh/nhà cung cấp và các phiên.
• ~/.openclaw/workspace/ — không gian làm việc của tác nhân (SOUL.md, bộ nhớ, hiện vật).

Dữ liệu này vẫn tồn tại sau khi khởi động lại và việc sử dụng SSD thay cho thẻ SD giúp cải thiện cả hiệu năng lẫn tuổi thọ. Tạo một bản chụp nhanh có thể di chuyển bằng:

openclaw backup create

Khắc phục sự cố

Hết bộ nhớ — xác minh swap đang hoạt động bằng free -h. Tắt các dịch vụ không sử 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 năng chậm — sử dụng SSD USB thay cho thẻ SD. Kiểm tra hiện tượng giảm xung CPU bằng vcgencmd get_throttled (kết quả phải là 0x0).

Dịch vụ không khởi động — kiểm tra nhật ký bằng journalctl --user -u openclaw-gateway.service --no-pager -n 100 và chạy openclaw doctor --non-interactive. Nếu đây là Pi không màn hình, cũng cần xác minh chế độ duy trì đã được bật: sudo loginctl enable-linger "$(whoami)".

Sự cố tệp nhị phân ARM — nếu một skill gặp lỗi "exec format error", hãy kiểm tra xem tệp nhị phân có bản dựng ARM64 hay không. Xác minh kiến trúc bằng uname -m (kết quả phải là aarch64).

WiFi bị ngắt kết nối — tắt tính năng quản lý điện năng WiFi: sudo iwconfig wlan0 power off.

Các bước tiếp theo

• Kênh — kết nối Telegram, WhatsApp, Discord và nhiều dịch vụ khác
• Cấu hình Gateway — tất cả tùy chọn cấu hình
• Cập nhật — luôn sử dụng phiên bản OpenClaw mới nhất

Liên quan

• Tổng quan về cài đặt
• Máy chủ Linux
• Nền tảng