OpenClaw（小龙虾）一键部署完整教程（避坑版）

这篇教程带你从 0 开始，在 VPS 上完整部署 OpenClaw，并解决常见安装问题。

关注公众号后回复 ai 获取 tokens 省钱攻略

一、准备工作

1. 服务器要求

• 一台 VPS（推荐海外服务器）
• 配置建议：
• 2GB 内存
  
  ：轻度使用
• 4GB+ 内存
  
  ：长期运行 / 多任务

2. 为什么选择海外服务器？

主要两个原因：

• 不需要备案
  
  ：国内服务器部署服务基本都要备案
• 网络限制少
  
  ：可直接访问各种 AI API

二、系统初始化（Debian11+或Ubuntu22+）

更新系统

sudo apt update && sudo apt upgrade -y

安装基础工具

sudo apt install -ycurlgit ca-certificates gnupg lsb-release cmake make build-essential

这些工具用于后续编译和依赖安装。

三、安装 Node.js（必须 22+）

Debian 默认版本过低，需要手动安装：

curl-fsSL https://deb.nodesource.com/setup_22.x | sudo-Ebash-sudo apt install -y nodejs

验证：




node --version

确保输出为：
v22.x.x



四、安装 OpenClaw
官方脚本不稳定，建议直接使用 npm：




npm install -g openclaw@latest


五、常见安装问题（重点）
1. CMake 报错






sudo apt install -y python3-pippip3 install cmake --upgradecmake --version


要求版本 ≥ 3.28

2. CMake 不在 PATH





export PATH="$HOME/.local/bin:$PATH"echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

3. 重新安装





rm -rf ~/.npm-global/lib/node_modules/openclawnpm install -g openclaw@latest

4. openclaw 命令不存在





export PATH="$HOME/.npm-global/bin:$PATH"echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc

六、接入低价 API（推荐）
安装插件：
openclaw plugins install openclaw-aicodewith-authopenclaw plugins enable openclaw-aicodewith-auth


重启：




openclaw gateway restart

配置 API Key：




openclaw models auth login --provider aicodewith-claude --set-default

查看模型：
openclaw models list | grep aicodewith



七、初始化 OpenClaw




openclaw onboard --install-daemon

推荐配置：


daemon：Yes


模式：Quick Start


Provider：aicodewith


模型：任选


Skills：按需选择


API：可跳过


Hooks：全部开启




八、验证运行
openclaw gateway status

看到运行状态即表示部署成功。


九、总结
整个部署流程可以概括为：

系统更新 → Node.js → OpenClaw → 修复依赖 → 接入 API → 初始化