树莓派 4B 8GB 部署 OpenClaw：把你的 Pi 变成 24 小时在线的 AI 网关

你是否想过拥有一个自己的 AI 助手，24 小时在线、通过 Telegram/WhatsApp 随时聊天、并且完全掌控在自己的硬件上？OpenClaw 就是一个这样的开源 AI Gateway（网关）—— 它运行在你的树莓派上，连接各种聊天软件到 AI 模型，让你从口袋里就能和 AI 对话。

最棒的是：OpenClaw 在 Pi 上只负责消息路由和 Agent 逻辑，AI 模型本身通过云端 API 调用（Anthropic、OpenAI、DeepSeek 等），所以即使树莓派 4B 的算力也完全够用。整套硬件成本只需一次性 35-80 美元，没有月费。

💡 适用场景：通过 Telegram 随时咨询 AI、自动管理日程、定时任务提醒、个人知识库查询、联网搜索助手……总之，一个口袋里的 AI 管家。

一、硬件和软件准备

在开始之前，请确保你有以下物品：

物品 规格要求 备注
树莓派 4B 2GB / 4GB / 8GB 本文使用 8GB 版本，性能良好
MicroSD 卡 16GB 以上 建议 32GB 以上 Class 10
USB-C 电源 官方 5V 3A 电源 非官方电源可能导致降频
网络连接 以太网或 WiFi 以太网更稳定
操作系统 Raspberry Pi OS 64-bit 必须 64 位！不要用 32 位

本文使用 Raspberry Pi 4B (8GB) + Raspberry Pi OS Full（带桌面版）作为演示环境。

1

烧录操作系统

首先在你的电脑上下载并安装 Raspberry Pi Imager。

  1. 打开 Raspberry Pi Imager
  2. 点击 “Choose Device” → 选择 Raspberry Pi 4
  3. 点击 “Choose OS” → 选择 Raspberry Pi OS (64-bit)（Full 版带桌面，或者 Lite 版不带桌面）
  4. 点击 “Choose Storage” → 选择你的 MicroSD 卡
  5. 点击右下角的齿轮图标 ⚙️，在高级选项中预先配置：
    • 设置主机名（如 openclaw-pi）
    • 启用 SSH（如果要用远程连接）
    • 设置用户名和密码
    • 配置 WiFi（如果不使用网线）
  6. 点击 “Write” 开始烧录
💡 有显示器吗？ 如果你用的是带桌面的 Full 版系统，可以直接插显示器、键盘、鼠标操作，不需要 SSH。下面的步骤在 Pi 的终端（Ctrl+Alt+T）里直接执行即可。

烧录完成后，把 SD 卡插入树莓派，插上电源开机。

2

连接树莓派

方式一：有桌面（Full 版）
直接插上 HDMI 显示器、键盘鼠标，系统启动后自动进入桌面。打开终端（快捷键 Ctrl+Alt+T）。

方式二：无桌面（Lite 版 / 远程）
在电脑终端中通过 SSH 连接：

$ ssh pi@openclaw-pi.local

输入之前设置的密码即可登录。

3

更新系统

无论是桌面版还是 Lite 版，首先更新系统软件包：

$ sudo apt update $ sudo apt upgrade -y $ sudo apt install -y git curl build-essential

然后设置正确的时区（这对定时任务和提醒功能很重要）：

$ sudo timedatectl set-timezone Asia/Shanghai
4

安装 Node.js 24

OpenClaw 需要 Node.js 24.15+（或兼容的 22 LTS）。使用官方源安装：

$ curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash – $ sudo apt install -y nodejs

验证安装成功：

$ node –version v24.x.x
5

安装 OpenClaw

用官方一键安装脚本：

$ curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后，验证：

$ openclaw –version
6

运行新手引导

这是最关键的一步——新手引导会带你完成模型提供商配置和渠道连接：

$ openclaw onboard –install-daemon

按照向导的提示操作：

  1. 选择模型提供商——如 Anthropic Claude、OpenAI GPT、DeepSeek 等。输入你的 API Key。
  2. 选择消息渠道——推荐先连 Telegram，最容易上手。
  3. 安装 systemd 服务——使 OpenClaw 在后台持续运行。

对于有桌面环境的 Pi，OAuth 登录流程会弹出浏览器窗口，比无头设备更方便。

💡 关于 API Key：引导过程中输入的 API Key 会保存在配置文件中，安全可靠。推荐使用 Anthropic Claude Sonnet 4 或 OpenAI GPT-5 系列模型。
7

启用用户驻留（重要！）

如果使用 systemd 用户服务，这一步必须执行，否则退出 SSH 或关闭终端后服务就会停止：

$ sudo loginctl enable-linger “$(whoami)”
8

验证安装

检查 OpenClaw 是否正常运行：

$ openclaw status

查看服务状态：

$ systemctl –user status openclaw-gateway.service

查看实时日志：

$ journalctl –user -u openclaw-gateway.service -f
9

连接 Telegram 并开始聊天

如果你在新手引导中选择了 Telegram，现在可以打开 Telegram 搜索你的 Bot，发送 /start 开始对话。

或者，直接在树莓派的浏览器中打开控制面板：

$ openclaw dashboard

这会在浏览器中打开一个 Web 管理界面，你可以在这里直接聊天、管理配置、查看会话。

10

性能优化（可选但推荐）

为了让树莓派上的 OpenClaw 运行更流畅，建议做以下优化：

启用编译缓存

Node.js 的模块编译在低功耗设备上较慢，启用缓存可以显著加速：

$ cat >> ~/.bashrc <<‘EOF’ export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache mkdir -p /var/tmp/openclaw-compile-cache export OPENCLAW_NO_RESPAWN=1 EOF $ source ~/.bashrc

配置 systemd 自动重启

让 OpenClaw 崩溃后自动恢复：

$ systemctl –user edit openclaw-gateway.service

在弹出的编辑器中粘贴以下配置：

[Service] Environment=OPENCLAW_NO_RESPAWN=1 Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache Restart=always RestartSec=2 TimeoutStartSec=90

保存后重启服务：

$ systemctl –user daemon-reload $ systemctl –user restart openclaw-gateway.service

降低内存占用（桌面版可跳过）

如果你用的是无头 Lite 版，可以释放 GPU 内存并禁用蓝牙：

$ echo ‘gpu_mem=16’ | sudo tee -a /boot/config.txt $ sudo systemctl disable bluetooth
⚠️ 桌面版用户注意：如果你用的是带桌面的 Full 版，不要执行上面的 GPU 内存和蓝牙禁用命令，因为桌面系统需要 GPU 渲染，蓝牙可能连接键盘鼠标。

推荐的模型配置

OpenClaw 在树莓派上只做 Gateway 网关，不运行本地模型。在配置文件中使用云 API 模型：

{ “agents”: { “defaults”: { “model”: { “primary”: “anthropic/claude-sonnet-4-6”, “fallbacks”: [“openai/gpt-5.4-mini”] } } } }
11

数据备份

OpenClaw 的状态数据保存在以下位置：

  • ~/.openclaw/ —— 配置文件、认证信息、会话数据
  • ~/.openclaw/workspace/ —— Agent 工作区

创建完整快照备份：

$ openclaw backup create

常见问题

问题 检查方法 解决方法
服务无法启动 journalctl --user -u openclaw-gateway.service --no-pager -n 100 运行 openclaw doctor --non-interactive
内存不足 free -h 禁用不用的服务，仅用 API 模型
性能慢 vcgencmd get_throttled（应返回 0x0） 换 USB SSD，检查散热
WiFi 断连 — sudo iwconfig wlan0 power off
ARM 二进制错误 uname -m（应显示 aarch64） 检查是否有 linux-arm64 构建

🎉 你的 AI Gateway 已就绪！

现在你的树莓派 4B 已经成为一个 24 小时在线的 AI 网关。
你可以通过 Telegram 随时向它提问、让它帮你查资料、管理日程，
甚至编写自动化任务——全部运行在你自己的硬件上。

📖 延伸阅读：
OpenClaw 官方文档 · GitHub 仓库

后记：关于 Token 消耗

有读者可能会问：”树莓派这么低的算力，跑 AI 会不会很慢？” 答案是不会。OpenClaw 在 Pi 上只负责消息路由和 Agent 逻辑编排，所有的 AI 模型推理都在云端 API 完成。你在 Telegram 上发送一条消息，Pi 收到后通过 API 调用 Claude/GPT 等模型，再把结果返回给你。整个过程 Pi 只做”传话”和”调度”，所以即使是最低配的 Pi 4B 2GB 也能轻松应对。

唯一的成本就是你选择的云 API 的 Token 费用——这也是为什么建议选择性价比高的模型（如 Claude Sonnet 或 GPT-5 mini 系列）作为主力模型。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注