> ## Documentation Index
> Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspberry Pi

# 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

<Steps>
  <Step title="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](https://www.raspberrypi.com/software/).
    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.
  </Step>

  <Step title="Kết nối qua SSH">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    ssh user@gateway-host
    ```
  </Step>

  <Step title="Cập nhật hệ thống">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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
    ```
  </Step>

  <Step title="Cài đặt Node.js 24">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt install -y nodejs
    node --version
    ```
  </Step>

  <Step title="Thêm swap (quan trọng cho 2 GB RAM hoặc ít hơn)">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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
    ```
  </Step>

  <Step title="Cài đặt OpenClaw">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Step>

  <Step title="Chạy onboarding">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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.
  </Step>

  <Step title="Xác minh">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw status
    sudo systemctl status openclaw
    journalctl -u openclaw -f
    ```
  </Step>

  <Step title="Truy cập giao diện điều khiển">
    Trên máy tính, lấy URL dashboard từ Pi:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    ssh user@gateway-host 'openclaw dashboard --no-open'
    ```

    Sau đó tạo một SSH tunnel trong terminal khác:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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](/gateway/tailscale).
  </Step>
</Steps>

## 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](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot).

**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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

* [Channels](/channels) — kết nối Telegram, WhatsApp, Discord và nhiều hơn nữa
* [Cấu hình Gateway](/gateway/configuration) — tất cả tùy chọn cấu hình
* [Cập nhật](/install/updating) — giữ OpenClaw luôn cập nhật