硬件：
- Raspberry Pi 4B 2GB 内存
- 三星 128GB 白卡
准备工作
系统安装
使用官方工具 Raspberry Pi Imager 将系统烧录至 tf 卡。 安装的系统版本为 Raspberry Pi OS Lite (64-bit)
- Kernel version: 6.12
- Debian version: 13 (trixie)
修改镜像源
该版本的镜像源采用 DEB822 格式
Debian 镜像源修改
参考debian | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
sudo nano /etc/apt/sources.list.d/debian.sources
注释原内容后添加以下内容：
Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/debian
Suites: trixie trixie-updates trixie-backports
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
# Types: deb-src
# URIs: https://mirrors.tuna.tsinghua.edu.cn/debian
# Suites: trixie trixie-updates trixie-backports
# Components: main contrib non-free non-free-firmware
# Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
# Types: deb-src
# URIs: https://security.debian.org/debian-security
# Suites: trixie-security
# Components: main contrib non-free non-free-firmware
# Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Raspberrypi 镜像源修改
sudo nano /etc/apt/sources.list.d/raspi.sources
注释原 URIs 行后修改为以下内容：
# URIs: http://archive.raspberrypi.com/debian/
URIs: https://mirrors.tuna.tsinghua.edu.cn/raspberrypi/
应用修改
sudo apt update
包升级与安装
sudo apt upgrade
sudo apt install vim
sudo apt install -y git curl build-essential
# node
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# verify
node --version
npm --version
添加 swap 文件及内存优化
# Create 2GB swap file
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# Make permanent
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# Optimize for low RAM (reduce swappiness)
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
安装 OpenClaw
龙虾，启动！
curl -fsSL https://openclaw.ai/install.sh | bash
此刻跟随命令行交互进行设置或者稍后运行 openclaw config 进行配置。
安装完成后你需要重启客户端或者运行 source ~/.bashrc
OpenClaw 配置
没有特意列出的选项均为默认
Model
OpenRouter -> StepFun: Step 3.5 Flash (free) 测试场景，选一个免费、推理速度快、性能尚可的模型。
Gateway
- port: 18789
- bind mode: All interface (LAN)
Channels
飞书
在大陆还是使用飞书或者钉钉比较方便，没有网络问题。 参考OpenClaw飞书官方插件完成飞书插件的安装以及飞书机器人的接入。
Skills
按需安装。
Dashboard
通过 http://<raspberry-pi IP>:18789 访问 OpenClaw Dashboard，如遇到问题请参考 Troubleshooting。
将上一步配置 Gateway 时生成的 toekn 填入 [Overview]-[Gateway Access]-[Gateway Token]
应用场景
TODO
Troubleshooting
浏览器访问 Dashboard 显示安全问题
由于树莓派安装的是 server 版本的系统，我们通过设备的浏览器以 http://<raspberry-pi IP>:18789 的地址访问 dashboard，通常会遇到以下两个问题：
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)control ui requires device identity (use HTTPS or localhost secure context)
解决方案：
- 允许特定源 & 禁用设备身份检查。
openclaw config set gateway.controlUi.allowedOrigins '["http://<your-droplet-ip>:18789"]' --strict-json
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
openclaw gateway restart
请注意该解决方案并不安全，仅供测试使用！
更安全的方案应该是 SSH Tunnel 或者 Tailscale。