OpenClaw 树莓派安装教程 2026：ARM低功耗5W部署指南

教程说明：本文详解如何在树莓派5（Raspberry Pi 5）及树莓派4B上安装和运行 OpenClaw AI 智能体平台。树莓派 ARM 架构功耗仅5-7W，是 24 小时常驻运行 OpenClaw 的理想低成本方案。全程含硬件准备、系统烧录、依赖安装、网络配置和开机自启动设置。

为什么选择树莓派运行 OpenClaw？

5-7W

典型功耗

¥600

树莓派5起售价

24h

不间断运行

ARM64

原生支持

超低能耗

每月电费不足2元，比传统服务器省电95%以上，适合家庭长期在线部署。

零噪音运行

被动散热方案静音运行，客厅、卧室均可放置，不影响生活环境。

即插即用

MicroSD 或 NVMe SSD 启动，体积仅手掌大，随时携带随时部署。

硬件要求与推荐配置

🥇

树莓派5（8GB）— 强烈推荐

最佳选择，性能充沛

8GB

LPDDR4X内存

ARM Cortex-A76

四核2.4GHz

5-7W

典型功耗

PCIe 2.0

支持NVMe SSD

树莓派5（4GB）— 推荐

够用，略有限制

运行单个 OpenClaw 实例完全够用，同时跑多个AI工作流时可能有压力，建议限制并发对话数量。

树莓派4B（4GB/8GB）— 可用

性能稍弱，稳定运行

Cortex-A72 处理器，Node.js 编译和启动速度略慢，但长期运行 OpenClaw 稳定，适合预算有限的用户。

所需附件清单

MicroSD 卡（32GB+）或 NVMe SSD

推荐 SanDisk Extreme Pro A2 或 WD Black SN770M

USB-C 电源适配器（5V/5A）

树莓派5需要至少 27W 供电，建议官方电源

散热外壳或主动风扇

树莓派5原装主动冷却外壳为最佳选择

网线（推荐有线连接）

千兆以太网，稳定性优于 Wi-Fi

第一步：烧录 Raspberry Pi OS

使用官方 Raspberry Pi Imager 烧录

下载 Raspberry Pi Imager（官网：raspberrypi.com/software），安装并启动

选择设备：Raspberry Pi 5（或 4）；操作系统：Raspberry Pi OS (64-bit) Lite（无桌面，适合服务器运行）

点击「高级设置」：启用 SSH、设置用户名密码（如 pi / yourpassword）、配置 Wi-Fi（若不用网线）

写入完成后插入树莓派，接通电源，等待约 30 秒启动完成

第二步：SSH 连接与系统初始化

Terminal / PowerShell

# 扫描局域网找到树莓派IP（Mac/Linux）

arp -a | grep -i "raspberry\|b8:27:eb\|dc:a6:32\|e4:5f:01"

# 或直接连接（替换为实际IP）

ssh [email protected]

# 更新系统（首次必做）

sudo apt update && sudo apt upgrade -y

# 安装必要工具

sudo apt install -y git curl wget build-essential

第三步：安装 Node.js 22（通过 NVM）

注意：树莓派 ARM64 架构完全支持 NVM，但 nvm 安装脚本需要从 GitHub 下载，国内网络可能超时。建议使用 VPN07 代理或镜像源解决。

安装 NVM + Node.js 22

# 安装 nvm（可能需要代理）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 加载 nvm（或重新打开终端）

source ~/.bashrc

# 安装 Node.js 22 LTS

nvm install 22

nvm use 22

nvm alias default 22

# 验证安装（ARM64 架构确认）

node -v # 应显示 v22.x.x

uname -m # 应显示 aarch64

第四步：克隆并安装 OpenClaw

安装 OpenClaw

# 克隆 OpenClaw 仓库

git clone https://github.com/openclaw-ai/openclaw.git ~/openclaw

cd ~/openclaw

# 安装依赖（树莓派编译原生模块会较慢，耐心等待）

npm install

# 复制配置文件

cp .env.example .env

# 编辑配置文件，填入 API Key

nano .env

.env 关键配置项说明

OPENAI_API_KEY OpenAI API 密钥，用于 GPT-4o 等模型

ANTHROPIC_API_KEY Claude API 密钥，用于 Claude 3.7 Sonnet 等模型

PORT 监听端口，默认 18789，可改为 3000 或其他

HOST 设为 0.0.0.0 允许局域网其他设备访问

第五步：测试运行 OpenClaw

# 前台运行测试

npm start

# 看到以下输出则表示成功：

[OpenClaw] Server running at http://0.0.0.0:18789

[OpenClaw] WebUI: http://192.168.1.100:18789

在同一局域网的电脑或手机浏览器中打开 http://[树莓派IP]:18789 即可访问 OpenClaw WebUI，确认可以正常使用后继续配置 systemd 自启动。

第六步：配置 systemd 开机自启动

创建 systemd 服务文件

sudo nano /etc/systemd/system/openclaw.service

服务文件内容（替换 pi 为实际用户名）

[Unit]

Description=OpenClaw AI Agent

After=network-online.target

Wants=network-online.target

[Service]

Type=simple

User=pi

WorkingDirectory=/home/pi/openclaw

ExecStart=/home/pi/.nvm/versions/node/v22.14.0/bin/node /home/pi/openclaw/src/index.js

Restart=always

RestartSec=10

Environment=NODE_ENV=production

[Install]

WantedBy=multi-user.target

启用并启动服务

sudo systemctl daemon-reload

sudo systemctl enable openclaw

sudo systemctl start openclaw

# 查看运行状态

sudo systemctl status openclaw

# 查看实时日志

journalctl -u openclaw -f

防休眠与稳定性配置

禁用系统休眠

sudo systemctl mask sleep.target

sudo systemctl mask suspend.target

sudo systemctl mask hibernate.target

sudo systemctl mask hybrid-sleep.target

降低 CPU 调频（节能长跑）

# 写入 /boot/config.txt

arm_freq=1800

over_voltage=2

# 或使用 powersave 调速

echo powersave | sudo tee /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

常见问题与解决方案

❓ npm install 时原生模块编译失败

ARM64 架构编译原生 Node 模块需要 gcc 和 python3：

sudo apt install -y gcc g++ make python3 python3-pip

❓ nvm 安装脚本连接 GitHub 超时

树莓派国内网络访问 GitHub 不稳定，需要通过 VPN07 代理解决：在路由器层面配置 VPN07，或在树莓派上设置 HTTP_PROXY 环境变量，使用 VPN07 的 1000Mbps 高速节点确保下载不超时。

❓ AI API 调用频繁失败或延迟过高

Claude/OpenAI API 国内访问延迟高。推荐在树莓派所在路由器配置 VPN07 透明代理，所有设备的 API 请求自动走 VPN07 全球节点加速，延迟降低 60-80%。

❓ 服务重启后 WebUI 端口不可访问

检查防火墙和端口监听状态：

sudo ss -tlnp | grep 18789

sudo ufw allow 18789/tcp

树莓派5 运行 OpenClaw 性能数据

~2s

平均响应延迟

5并发

稳定支持数

6.3W

满载功耗

~¥1.5/月

电费估算

网络优化：解锁全球 AI API 访问

树莓派部署 OpenClaw 的核心挑战是网络访问。国内访问 OpenAI、Claude、GitHub 等服务受限，严重影响 OpenClaw 使用体验。推荐解决方案：

方案一：路由器层代理（最推荐）

在路由器安装 VPN07，树莓派无需额外配置，自动享受 1000Mbps 全球加速

方案二：树莓派本机代理

在树莓派安装 VPN07 Linux 客户端，设置 HTTP_PROXY 变量为 npm 和 curl 加速

VPN07 优势：运营十年，70+ 全球节点，1000Mbps 千兆带宽，稳定支持树莓派 ARM 架构 Linux 客户端，30 天无理由退款。

立即使用 VPN07

树莓派 OpenClaw 部署最优网络解决方案

VPN07 运营十年，支持 Linux ARM 架构客户端，1000Mbps 千兆带宽覆盖全球 70+ 节点。完美解决树莓派安装 npm 超时、AI API 连接失败问题，30 天退款保证，¥9/月起，国际大牌品质。

¥9/月

超低月费

1000Mbps

千兆带宽

70+国家

全球节点

30天

退款保证

免费试用 VPN07 查看价格方案

OpenClaw 树莓派安装教程 2026：ARM低功耗5W设备完整部署指南