树莓派 5 部署教程

最强树莓派 + AI Agent = 几百块的私人服务器

为什么树莓派 5 是最佳选择

树莓派 5 是目前性能最强的树莓派，跑 OpenClaw 完全不在话下。4GB 版能用，8GB 版更稳。几百块钱买一块板子，功耗十来瓦，24 小时开着电费忽略不计，比什么云服务器都划算。

整个过程大概半小时就能搞定，跟着下面的步骤走就行。

你需要准备这些

🍓

树莓派 5 (4GB/8GB)

推荐 8GB 版本，跑 Docker 容器更从容，不容易 OOM

💾

64GB MicroSD 卡

A2 级别高速卡，推荐三星 EVO Plus 或闪迪 Extreme

🌀

散热风扇

官方主动散热器最省事，ICE Tower 效果更好但贵一点

🔌

27W USB-C 电源

Pi 5 需要 5V/5A 电源，别用手机充电器凑合，供电不足会降频

第一步：更新系统

拿到板子刷好系统之后，先把包管理器更新一下，装几个后面要用的依赖：

更新系统 & 安装依赖

# 更新包列表和已安装的包
sudo apt update && sudo apt upgrade -y

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

# 确认架构是 arm64
uname -m
# 应该输出 aarch64

第二步：安装 Docker

树莓派 OS 是基于 Debian 的，装 Docker 官方源就行：

在树莓派 OS 上安装 Docker

# 添加 Docker 官方 GPG 密钥
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

# 添加 Docker 仓库（Raspberry Pi OS 基于 Debian）
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

# 安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 把当前用户加入 docker 组（不用每次 sudo）
sudo usermod -aG docker $USER
newgrp docker

# 验证安装
docker --version
docker compose version

第三步：配置 docker-compose

创建一个目录，把配置文件写好：

创建项目目录

mkdir -p ~/openclaw && cd ~/openclaw

docker-compose.yml 完整示例

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
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 512M
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3

完整流程一览

刷系统

用 Raspberry Pi Imager 把 Raspberry Pi OS (64-bit) 烧录到 SD 卡上。选 Lite 版就够了，不需要桌面环境。

更新系统

插卡开机，联网后 apt update && apt upgrade，把系统更新到最新。

装 Docker

按上面的步骤装好 Docker 和 docker-compose，确认 docker --version 输出正常。

写配置文件

创建 docker-compose.yml，把上面的配置粘贴进去，根据需要改端口和内存限制。

启动服务

运行 docker compose up -d，然后浏览器打开 http://树莓派IP:3000，看到界面就成了。

启动和验证

启动 OpenClaw

cd ~/openclaw

# 拉取镜像（ARM64 版本会自动匹配）
docker compose pull

# 后台启动
docker compose up -d

# 查看日志确认启动成功
docker compose logs -f
# 看到 "Server is running on port 3000" 就行了

# 查看状态
docker ps

💡 8GB 版本更稳定：4GB 版也能跑，但在并发请求多的时候偶尔会触发 OOM。如果还没买板子，直接入 8GB 版，多花几十块钱但省掉后面很多调优的麻烦。

不想折腾刷系统装 Docker？MOLILI 支持 ARM 架构，预装好的镜像直接烧录进去，开机就能用。了解 MOLILI →

这篇教程对你有帮助吗？