树莓派 4B 部署教程

老款也能跑 —— 4GB版就够用了

Pi 4 还能打吗?能!

如果你手边有一块吃灰的树莓派 4B,别急着淘汰它。4GB 版跑 OpenClaw 完全够用,8GB 版更是绰绰有余。虽然比 Pi 5 慢一些,但作为 24 小时在线的个人服务器,性能足够了。

Pi 4 和 Pi 5 的部署步骤大体相同,这篇主要说差异和需要特别注意的地方。

和 Pi 5 有什么区别

项目树莓派 4B树莓派 5
CPUCortex-A72 4核 1.5GHzCortex-A76 4核 2.4GHz
性能差距基准线约 2-3 倍提升
内存1/2/4/8 GB4/8 GB
供电5V/3A USB-C5V/5A USB-C
跑 OpenClaw够用,启动稍慢流畅,推荐

说白了就是 Pi 4 慢一点,启动容器大概要多等 10-20 秒,日常用起来体感差别不大。

安装步骤

和 Pi 5 基本一样,系统刷好之后:

系统更新 & Docker 安装
# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装依赖
sudo apt install -y ca-certificates curl gnupg lsb-release git

# 安装 Docker(官方源)
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 加入 docker 组
sudo usermod -aG docker $USER
newgrp docker

适合 Pi 4 的 docker-compose 配置

Pi 4 内存比较紧张,配置里要把资源限制设严一点,防止跑崩:

docker-compose.yml(Pi 4 优化版)
version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production
      - TZ=Asia/Shanghai
      - OPENCLAW_LITE=true    # 启用轻量模式
    deploy:
      resources:
        limits:
          memory: 1536M       # Pi 4 内存紧张,限制在 1.5G
          cpus: "3.0"         # 留一个核给系统
        reservations:
          memory: 256M
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 60s           # 检查间隔拉长,减少开销
      timeout: 15s
      retries: 3

Swap 设置(2GB 版必做)

⚠️ 2GB 内存的 Pi 4 一定要设 swap,不然内存不够会直接被 OOM Killer 杀掉进程。4GB 版也建议设一下,有备无患。

Raspberry Pi OS 默认有 100MB 的 swap,太小了,我们改大一点:

扩大 Swap 空间
# 先关掉当前的 swap
sudo dphys-swapfile swapoff

# 修改 swap 大小(单位 MB)
sudo sed -i "s/CONF_SWAPSIZE=.*/CONF_SWAPSIZE=2048/" /etc/dphys-swapfile

# 如果用的是 SSD,可以放心开大一点
# SD 卡的话 2048 就够了,太大会影响卡的寿命

# 重新初始化 swap
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

# 确认生效
free -h
# Swap 那一行应该显示 2.0Gi

启动服务

启动 OpenClaw
mkdir -p ~/openclaw && cd ~/openclaw

# 把上面的 docker-compose.yml 保存到这个目录

# 拉镜像(第一次会比较慢,耐心等)
docker compose pull

# 启动
docker compose up -d

# 看日志
docker compose logs -f

# Pi 4 启动比 Pi 5 慢,等个 30 秒到 1 分钟属于正常
Pi 4 内存不够折腾?MOLILI 云端托管,不受硬件限制,注册即用。 了解 MOLILI →
这篇教程对你有帮助吗?