Raspberry Pi

在 Raspberry Pi 上部署 OpenClaw。

支持的型号

型号	支持状态	备注
Pi 4	✅ 最佳	4GB+ RAM 推荐
Pi 3	✅ 支持	需要 SD 卡高性能
Pi 2	⚠️ 可用	性能有限
Pi Zero	❌ 不推荐	资源不足

系统要求

• Raspberry Pi 4 (推荐 4GB+)
• microSD 卡 (32GB+, A2 速度)
• 电源适配器 (5V 3A)
• 操作系统: Raspberry Pi OS 64-bit

安装

1. 系统准备

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

# 安装 Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

2. 安装 OpenClaw

# 使用 Docker 安装
docker run -d \
  --name openclaw \
  --device /dev/ttyAMA0 \
  -p 8211:8211 \
  -v openclaw-data:/data \
  openclaw/openclaw:arm64

3. 启用串口 (可选)

# 启用串口
sudo raspi-config
# Interface Options > Serial Port > Yes

# 添加用户到 dialout 组
sudo usermod -aG dialout $USER

配置

platform:
  raspberrypi:
    model: "4b"
    memory: "4gb"
    docker:
      image: "openclaw/openclaw:arm64"
    serial:
      enabled: false
      port: "/dev/ttyAMA0"
    gpio:
      enabled: false
      pins: []

性能优化

# 启用内存交换
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

# GPU 内存分配
sudo raspi-config
# Performance Options > GPU Memory > 256

常见问题

Docker 镜像问题

# 检查 Docker 版本
docker --version

# 如果不支持 ARM64，使用 x86 模拟 (不推荐)
# 或手动编译

内存不足

# 查看内存使用
free -h

# 清理 Docker
docker system prune -a

相关文档

• Linux - Linux 通用配置
• Docker - Docker 安装
• 节点管理 - 节点管理