树莓派部署OpenClaw的详细步骤与完整教程
时间:2026-06-03 11:42
树莓派部署OpenClaw:首先安装Git与Node js,并通过nvm安装Node js的22版本。安装完OpenClaw后,配置zai glm-4 7模型及APIKey,启动网关服务并使用SSH端口转发实现远程操控。接着安装Ollama的arm64版,运行glm-4 7:cloud模型,通过OpenClaw调用,最终在Web端验证模型返回成功完成。
## 1. Git与Node.js安装
先从基础环境说起。整个流程的第一步,是装好Git和Node.js——别看简单,踩坑的人不少。
装上Git,终端里敲一行:
```bash
sudo apt-get install git
```
接下来是nvm。这里用了Gitee镜像安装,省得被墙折腾:
```bash
wget -qO- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
```
脚本跑完后,别忘了把nvm加到环境变量里。把下面三行追加到`~/.bashrc`,然后重新加载配置:
```bash
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"' >> ~/.bashrc
source ~/.bashrc
```
现在用nvm安装Node.js 22版本,一条命令搞定:
```bash
nvm install 22
```
装完验证一下版本号,心里有底:
```bash
node -v
```

---
## 2. OpenClaw安装
OpenClaw安装脚本来自官方,直接curl下来跑。因为网络原因可能比较慢,耐心等一会儿:
```bash
curl -fsSL https://openclaw.bot/install.sh | bash
```

如果安装时遇到网络错误,别慌。先清一下npm缓存:
```bash
npm cache clean --force
```
再把npm镜像换成淘宝源:
```bash
npm config set registry https://registry.npmmirror.com
```
跑完这些,接下来就是配置阶段。选模型为`zai/glm-4.7`,输入自己的API Key。

看到下面这个界面,说明配置已经成功。

OpenClaw的命令可以这样查看:

⚠️⚠️⚠️ 重点来了:先启动OpenClaw网关:
```bash
openclaw gateway
```
然后用SSH连接到树莓派,开启端口转发。注意替换用户名和服务器IP:
```bash
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
```
输入密码后,在树莓派端输入:
```bash
openclaw dashboard
```
拿到Dashboard URL之后,就能通过局域网访问了。这一步实现了SSH连接的设备远程操控。

最后,在浏览器里打开Web端,随便问一句“你是什么大模型?”,如果返回的是`glm-4.7`,说明大模型已经成功调用了。

---
## 3. OpenClaw调用Ollama
树莓派上跑Ollama,版本要更新。官方安装脚本默认装arm版,但下载确实慢:
```bash
curl -fsSL https://ollama.com/install.sh | sh
```
嫌慢的话,可以换个路子。去GitHub上找Ollama的arm64版本发布页:
> https://github.com/ollama/ollama/releases/tag/v0.15.4

复制那个`ollama-linux-arm64.tar.zst`的链接。国内下载可以用加速站,比如:
https://github.akams.cn

然后在树莓派终端里直接wget下来:
```bash
wget https://gh.xxooo.cf/https://github.com/ollama/ollama/releases/download/v0.15.4/ollama-linux-arm64.tar.zst
```
接下来解压这个双层压缩包。先装zstd工具:
```bash
sudo apt-get install zstd
```
用zstd解成tar包:
```bash
zstd -d ollama-linux-arm64.tar.zst
```
再用tar解压:
```bash
tar -xvf ollama-linux-arm64.tar
```

解压后需要替换系统里的Ollama文件。用sudo把`lib/ollma`拷到`/usr/local/lib/`,再把`ollma`文件拷到`/usr/local/`。替换完输入`ollama --version`,确认版本号已经更新。

下一步,运行glm大模型:
```bash
ollma run glm-4.7:cloud
```
最后让OpenClaw调用Ollama:
```bash
ollama launch openclaw
```
打开浏览器输入`https://localhost:18789`,问一句“你是什么大模型”。如果返回`ollama/glm-4.7:cloud`,就说明Ollama已经成功接入OpenClaw,大功告成。
