Raspberry Pi

你需要准备的东西

首先，你需要一个叫“树莓派”的小电脑，它就像一个小盒子电脑。最好用树莓派 4 或 5 型号，内存至少有 2GB。你还需要一张小小的存储卡（叫 MicroSD 卡，16GB 以上），一个电源，还有网络线或者能连上家里的 WiFi。准备好这些，大概花 30 分钟就能装好。

第一步：给小电脑装上“大脑”（操作系统）

树莓派自己不会工作，需要先给它装一个“大脑”，也就是操作系统。我们用一个叫 Raspberry Pi Imager 的小工具来装。

1. 做什么：下载并运行安装工具。
2. 怎么做：在电脑上下载 Raspberry Pi Imager 软件。
3. 做什么：选择要安装的“大脑”。
4. 怎么做：在软件里选择 Raspberry Pi OS Lite (64-bit)，这个版本没有复杂的屏幕界面，正适合我们。
5. 做什么：提前设置好小电脑的名字和密码。
6. 怎么做：点击齿轮图标 ⚙️，设置主机名为 gateway-host，打开 SSH（这样你就能远程控制它），设置好用户名和密码，如果不用网线，还要设置 WiFi。
7. 做什么：把“大脑”写入存储卡。
8. 怎么做：选择你的 MicroSD 卡，点击“写入”。写完以后，把卡插到树莓派里，接上电源开机。

第二步：连接到你的小电脑

树莓派启动后，你需要从你自己的电脑上连接并控制它，这个过程叫 SSH。

1. 做什么：打开你自己电脑上的“终端”或“命令提示符”。
2. 怎么做：输入命令 ssh user@gateway-host。这里的 user 就是你刚才设置的用户名。如果连接不上，可以试试用树莓派的 IP 地址，比如 ssh user@192.168.x.x。

第三步：给小电脑做基础设置

连上以后，我们要先更新一下小电脑里的软件，并安装一些必要的工具。

1. 做什么：更新软件列表并升级。
   • 怎么做：输入 sudo apt update && sudo apt upgrade -y 然后按回车。
2. 做什么：安装必要的工具包，比如 git 和 curl。
   • 怎么做：输入 sudo apt install -y git curl build-essential。
3. 做什么：设置正确的时间，这很重要，不然提醒功能会不准。
   • 怎么做：输入 sudo timedatectl set-timezone America/Chicago，但要把 America/Chicago 改成你所在城市的时区，比如 Asia/Shanghai。

第四步：安装 Node.js

OpenClaw 是用一种叫 Node.js 的程序语言写的，所以我们需要先安装它。我们安装版本 22。

1. 做什么：获取 Node.js 的安装脚本。
   • 怎么做：输入 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -。
2. 做什么：安装 Node.js。
   • 怎么做：输入 sudo apt install -y nodejs。
3. 做什么：检查是否安装成功。
   • 怎么做：输入 node --version，如果显示 v22.x.x 就对了。再输入 npm --version 检查另一个工具。

第五步：增加“备用内存”（如果内存小）

如果你的树莓派内存只有 2GB 或更少，很容易因为内存不够而卡住。我们可以给它增加一些“备用内存”，叫做 swap。这就像当你玩具箱满了，先把一些不常用的玩具放到床底下的备用箱里。

1. 做什么：创建一个 2GB 大小的备用文件。
   • 怎么做：依次输入下面四行命令： sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
2. 做什么：让这个备用文件每次开机都自动生效。
   • 怎么做：输入 echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab。
3. 做什么：告诉小电脑不要太频繁地使用备用内存。
   • 怎么做：输入 echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf，然后输入 sudo sysctl -p 让它生效。

第六步：安装 OpenClaw

现在可以安装 OpenClaw 小助手了。有两种方法：

• 标准安装（推荐）：最简单，输入一条命令就行：curl -fsSL https://openclaw.ai/install.sh | bash。
• 可修改安装（适合喜欢折腾的人）：这样你可以看到所有代码和日志。需要输入： git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm run build npm link

第七步：运行设置向导

安装好后，运行一个简单的设置向导。

1. 做什么：启动设置。
   • 怎么做：输入 openclaw onboard --install-daemon。
2. 跟着向导一步步选：
   • Gateway mode：选 Local（本地模式）。
   • Auth：推荐选 API keys（用密钥验证），另一种 OAuth 在没有屏幕的树莓派上可能不好用。
   • Channels：可以先选 Telegram（一个聊天软件），这个最容易开始。
   • Daemon：选 Yes，这样小助手就能在后台一直运行了。

第八步：检查是否安装成功

设置完后，检查一下小助手是不是在好好工作。

1. 做什么：查看 OpenClaw 状态。
   • 怎么做：输入 openclaw status。
2. 做什么：查看后台服务的状态。
   • 怎么做：输入 sudo systemctl status openclaw。
3. 做什么：查看运行日志（就像看它的日记）。
   • 怎么做：输入 journalctl -u openclaw -f。

第九步：访问控制面板

树莓派没有屏幕，怎么看 OpenClaw 的控制面板呢？我们可以用“隧道”的方法，把你电脑的浏览器“连”到树莓派上。

1. 做什么：在你自己的电脑上打开终端，建立一条隧道。
   • 怎么做：输入 ssh -L 18789:localhost:18789 user@gateway-host。
2. 做什么：打开浏览器。
   • 怎么做：在浏览器地址栏输入 http://localhost:18789，就能看到控制面板了。

另一个好方法：安装一个叫 Tailscale 的工具，可以让你随时随地访问你的树莓派，就像它在你的身边一样。

1. 做什么：在树莓派上安装 Tailscale。
   • 怎么做：输入 curl -fsSL https://tailscale.com/install.sh | sh，然后输入 sudo tailscale up。
2. 做什么：告诉 OpenClaw 使用 Tailscale 网络。
   • 怎么做：输入 openclaw config set gateway.bind tailnet，然后输入 sudo systemctl restart openclaw 重启服务。

重要提醒和让电脑更快的方法

• 用 USB 固态硬盘（SSD）：这比用 MicroSD 卡快得多，也不容易坏。你需要按照树莓派官方的指南设置从 USB 启动。
• 给小电脑“减负”：如果树莓派只用来运行 OpenClaw，可以关掉一些用不上的功能来节省内存。比如，输入 echo 'gpu_mem=16' | sudo tee -a /boot/config.txt 可以减少给显卡的内存（因为我们不用屏幕）。输入 sudo systemctl disable bluetooth 可以关掉蓝牙（如果不用的话）。
• 它不能自己思考：树莓派只是一个小管家（Gateway），真正的“思考”工作（运行 AI 大模型）是在云端的服务器上完成的。所以不要尝试在树莓派上自己安装和运行 AI 大模型，那样会非常非常慢。你只需要在设置里选用像 Claude 或 GPT 这样的云端模型就可以了。
• 检查是否成功开机自启：输入 sudo systemctl is-enabled openclaw，如果显示 enabled，就说明小助手已经设置好，每次树莓派开机都会自动启动了。