英文 Raspberry Pi 安装
- 原始链接：https://docs.openclaw.ai/install/raspberry-pi
- 来源章节：3. 官方文档：安装、升级与部署
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/install/raspberry-pi
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
树莓派 - OpenClaw
[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)
英语
搜索...
Ctrl+K
搜索...
导航
托管
树莓派
安装概述
容器
托管
- Azure
- DigitalOcean
- Docker 虚拟机运行时
- exe.dev
- Fly.io
- GCP
- Hetzner
- Kubernetes
- Linux 服务器
- macOS 虚拟机
- 北翼
- Oracle云
- 铁路
- 树莓派
- 渲染
维护
在此页面上
托管
树莓派
树莓派
在 Raspberry Pi 上运行持久、始终在线的 OpenClaw 网关。由于 Pi 只是网关（模型通过 API 在云中运行），因此即使是普通的 Pi 也能很好地处理工作负载。
先决条件
- Raspberry Pi 4 或 5，具有 2 GB+ RAM（建议 4 GB）
- MicroSD 卡 (16 GB+) 或 USB SSD（性能更好）
- Pi官方电源
- 网络连接（以太网或WiFi）
- 64 位 Raspberry Pi 操作系统（必需 — 不要使用 32 位）
- 约30分钟
设置
1
刷新操作系统
使用 Raspberry Pi OS Lite（64 位） — 无头服务器不需要桌面。
1.下载【树莓派成像器】(https://www.raspberrypi.com/software/)。
2. 选择操作系统：Raspberry Pi OS Lite（64 位）。
3. 在设置对话框中，预配置：
* 主机名：网关主机
* 启用SSH
* 设置用户名和密码
* 配置 WiFi（如果不使用以太网）
- 闪存到 SD 卡或 USB 驱动器，将其插入，然后启动 Pi。
2
通过 SSH 连接
ssh 用户@网关主机3
更新系统
sudo apt 更新 && sudo apt 升级 -y
sudo apt install -y git curl build-essential
# 设置时区（对于 cron 和提醒很重要）
sudo timedatectl set-timezone 美洲/芝加哥4
安装 Node.js 24
卷曲-fsSL https://deb.nodesource.com/setup_24.x |须藤-E bash-
sudo apt install -y nodejs
节点--版本5
添加交换区（对于 2 GB 或更少很重要）
sudo fallocate -l 2G /交换文件
须藤 chmod 600 /交换文件
须藤 mkswap /交换文件
须藤交换/交换文件
echo '/swapfile 无 交换 sw 0 0' | sudo tee -a /etc/fstab
# 减少低 RAM 设备的交换
回声 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p6
安装 OpenClaw
卷曲-fsSL https://openclaw.ai/install.sh |巴什7
运行入职培训
openclaw 板载 --install-daemon按照向导操作。对于无头设备，建议使用 API 密钥而不是 OAuth。 Telegram 是最容易上手的渠道。
8
验证
开爪状态
systemctl --用户状态 openclaw-gateway.service
Journalctl --user -u openclaw-gateway.service -f9
访问控制用户界面
在您的计算机上，从 Pi 获取仪表板 URL：
ssh user@gateway-host 'openclaw 仪表板 --no-open'然后在另一个终端中创建 SSH 隧道：
ssh -N -L 18789:127.0.0.1:18789 用户@网关主机在本地浏览器中打开打印的 URL。对于始终在线的远程访问，请参阅Tailscale 集成。
性能提示
使用 USB SSD — SD 卡速度慢且磨损。 USB SSD 显着提高了性能。请参阅 Pi USB 启动指南。启用模块编译缓存 - 加速低功耗 Pi 主机上的重复 CLI 调用：
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: 白名单秘密
导出 NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
导出 OPENCLAW_NO_RESPAWN=1
EOF
源~/.bashrc减少内存使用 — 对于无头设置，释放 GPU 内存并禁用未使用的服务：
回显'gpu_mem = 16'| sudo tee -a /boot/config.txt
sudo systemctl 禁用蓝牙
故障排除
内存不足 — 使用“free -h”验证交换是否处于活动状态。禁用未使用的服务（“sudo systemctl禁用cups蓝牙avahi-daemon”）。仅使用基于 API 的模型。性能低下 — 使用 USB SSD 而不是 SD 卡。使用“vcgencmd get_throttled”检查 CPU 限制（应返回“0x0”）。服务将无法启动 — 使用“journalctl --user -u openclaw-gateway.service --no-pager -n 100”检查日志并运行“openclaw doctor --non-interactive”。如果这是无头 Pi，还要验证是否启用了延迟：sudo loginctl enable-linger "$(whoami)"。ARM 二进制问题 — 如果技能因“exec 格式错误”而失败，请检查二进制文件是否具有 ARM64 版本。使用“uname -m”验证架构（应显示“aarch64”）。WiFi 丢失 — 禁用 WiFi 电源管理：“sudo iwconfig wlan0 power off”。
后续步骤
Ctrl+I