树莓派部署

概述

树莓派是运行 OpenClaw 的理想低功耗设备，7×24 小时运行成本极低（约 5W 功耗），非常适合作为家庭 AI 助手的专用硬件。hello-claw 教程中的 PicoClaw 方案就是专门面向树莓派的轻量级部署。

推荐配置

配置项	最低要求	推荐配置
型号	Raspberry Pi 4B	Raspberry Pi 5
内存	4GB	8GB
系统	64 位 Raspberry Pi OS	64 位 Raspberry Pi OS
存储	32GB SD 卡	256GB+ SSD（USB 启动）
网络	Wi-Fi	有线网络
电源	官方适配器	官方适配器

使用 SSD 替代 SD 卡

SD 卡在长期读写下容易损坏。强烈建议通过 USB 外接 SSD 启动，显著提升稳定性和性能。

安装方式

方式一：Docker Compose（推荐）

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

# 创建配置目录
mkdir -p ~/.openclaw

# 启动
docker compose up -d

ARM 镜像

树莓派使用 ARM 架构，Docker 会自动拉取 ARM 版本的镜像。确保使用官方 openclaw/openclaw 镜像。

方式二：Node.js 直接安装

# 安装 Node.js 22（ARM 版本）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

# 安装 OpenClaw
npm install -g openclaw@latest

# 运行配置向导
openclaw onboard --install-daemon

性能优化

使用云端模型

树莓派内存有限，不建议运行本地模型（Ollama）。推荐使用云端 API：

• 硅基流动：国内推荐，新用户送 16 元
• OpenRouter：有免费模型可用
• 混元 hunyuan-lite：腾讯免费无限量模型

降低资源消耗

{
  "cron": {
    "maxConcurrentRuns": 1
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "siliconflow/deepseek-ai/DeepSeek-V3"
      }
    }
  }
}

开机自启

使用 systemd 设置开机自动启动：

# 安装时已通过 --install-daemon 自动配置
# 或手动管理
sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway

远程访问

树莓派通常没有显示器，推荐通过以下方式远程管理：

• SSH：ssh [email protected]
• Tailscale：跨网络远程访问，详见 远程访问
• Web Dashboard：http://raspberrypi.local:18789

适用场景

• 家庭 AI 助手（7×24 在线，随时通过手机发消息）
• 智能家居中枢（配合 IoT Skills）
• 小型服务器监控
• 个人定时任务执行器（每日简报、数据备份等）