树莓派安装 OpenClaw 并配置为 Node Host 节点

本文记录如何在树莓派上安装 OpenClaw，并将其作为 Node Host 连接到主 Gateway，实现远程命令执行和分布式任务管理。

什么是 Node Host

OpenClaw 的 Node Host 是一个远程执行节点，可以让你的 AI 助手在远程设备上执行命令。架构如下：

• Gateway（主机器）：接收消息、运行 AI 模型、路由工具调用
• Node Host（树莓派）：执行命令的"远程手脚"

前置条件

• 树莓派（已连接网络）
• 主机器已运行 OpenClaw Gateway
• 主机器 Gateway 绑定为 LAN 模式

步骤一：安装 Node.js

OpenClaw 需要 Node.js 22.12+，使用 NodeSource 安装：

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证版本
node --version  # 应显示 v22.x.x

步骤二：安装 OpenClaw

# 配置 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=$PATH:~/.npm-global/bin' >> ~/.bashrc
source ~/.bashrc

# 安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

步骤三：配置主机器 Gateway

主机器 Gateway 需要绑定到 LAN 模式，允许局域网访问：

# 在主机器上执行
openclaw config set gateway.bind lan
openclaw gateway restart

获取 Gateway Token：

cat ~/.openclaw/openclaw.json | grep -A3 '"auth"'

步骤四：创建 Node Host 服务

创建 systemd 服务文件，实现开机自启：

mkdir -p ~/.config/systemd/user

cat > ~/.config/systemd/user/openclaw-node.service << 'EOF'
[Unit]
Description=OpenClaw Node Host
After=network.target

[Service]
Type=simple
Environment=PATH=/usr/local/bin:/usr/bin:/bin:/home/saiita/.npm-global/bin
Environment=OPENCLAW_GATEWAY_TOKEN=你的gateway_token
Environment=OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1
ExecStart=/home/saiita/.npm-global/bin/openclaw node run --host 主机器IP --port 18789 --display-name "树莓派"
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
EOF

注意：OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 用于允许局域网非加密连接。

步骤五：启动服务

# 重载 systemd
systemctl --user daemon-reload

# 启用开机自启
systemctl --user enable openclaw-node.service

# 启动服务
systemctl --user start openclaw-node.service

# 查看状态
systemctl --user status openclaw-node.service

步骤六：批准配对请求

在主机器上查看并批准配对请求：

# 查看待批准请求
openclaw devices list

# 批准请求
openclaw devices approve <request-id>

步骤七：验证连接

# 查看节点状态
openclaw nodes status

# 测试执行命令
openclaw nodes run --node 树莓派 --raw "hostname && uptime"

支持的能力

• browser.proxy - 远程浏览器代理
• system.run - 执行 shell 命令
• system.which - 检查命令是否存在

应用场景

• 远程执行命令（无需 SSH）
• 浏览器自动化（headless）
• 家居自动化控制
• 24/7 后台任务
• 分布式任务执行

总结

通过将树莓派配置为 OpenClaw Node Host，可以让 AI 助手在树莓派上远程执行命令，无需手动 SSH。配合多台树莓派可以实现分布式任务处理和负载均衡。