2026年，AI领域最火的概念之一就是“AI代理”——让AI真正能“动手做事”，而不仅仅是“动嘴回答”。OpenClaw正是这类工具中的佼佼者。它是一款开源的AI自动化代理，可以部署在你的电脑或云服务器上，执行文件操作、浏览器自动化、消息收发等真实任务。

但与DeepSeek等大模型不同，OpenClaw的“大脑”通常调用云端大模型API，其本身对本地算力要求极低。这让它非常适合部署在云服务器上，实现7×24小时在线的“数字员工”。

本教程将带你从零开始，在云服务器上完整部署OpenClaw，并附上常见问题的解决方案。

一、部署前的环境准备

在开始安装之前，需要确保服务器满足以下基础环境要求。

系统要求：OpenClaw支持主流操作系统，包括Linux（Ubuntu 20.04+/Debian 11+/CentOS 8+）、macOS 12+和Windows 10/11。其中，Windows系统强烈建议在WSL2环境下运行。对于云服务器部署，推荐使用Ubuntu 22.04 LTS系统，兼容性最佳。

硬件配置：OpenClaw对硬件要求极低。最低配置仅需2核CPU、2GB内存、10GB可用磁盘空间。推荐配置为4核CPU、4GB以上内存、20GB以上磁盘空间。即使512MB-1GB内存的旧设备也能运行基础功能。云服务器2核4G的配置足以流畅运行多任务。

核心软件依赖：

- Node.js：版本必须 ≥ 22.x，推荐使用22.x或24.x LTS版本。

- 包管理器：npm（随Node.js安装）或pnpm。

- Git：用于拉取源码和插件（版本≥2.30.0）。

- 大模型API Key：OpenClaw本身不包含大模型，需要配置第三方大模型API。可选用阿里云百炼（国内直连，有免费额度）、硅基流动或OpenAI等。

网络要求：部署过程中需下载依赖包，建议网络带宽≥10Mbps。由于部分资源位于GitHub或npm官方源，在国内服务器上部署时，建议配置国内镜像源以加速下载。

二、视频教程：分步部署全过程

步骤一：登录服务器并更新系统

通过SSH工具（如Finalshell、Putty）登录你的云服务器。首先更新系统软件包至最新状态：

sudo apt update && sudo apt upgrade -y

步骤二：安装Node.js 22.x

OpenClaw的核心运行环境是Node.js。执行以下命令添加NodeSource仓库并安装：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E  -

sudo apt install -y nodejs

安装完成后，验证版本：

node --version   # 应显示 v22.x.x 或更高

npm --version    # 应显示 10.x.x 或更高

步骤三：安装Git

sudo apt install git -y

git --version    # 验证安装

步骤四：配置npm国内镜像（推荐）

为加速依赖包下载，配置淘宝镜像源：

npm config set registry https://registry.npmmirror.com

步骤五：安装OpenClaw

执行全局安装命令：

sudo npm install -g openclaw@latest

安装完成后，验证版本：

openclaw --version

步骤六：运行初始化配置向导

这是部署的核心步骤。执行以下命令启动交互式配置向导：

openclaw onboard

根据提示逐步操作：

- 风险提示：输入`Yes`确认AI将拥有本地文件操作权限。

- 模式选择：新手推荐选择`QuickStart`（快速启动）。

- 模型/渠道/技能配置：可选择`Skip for now`（稍后配置）。

- 交互方式：选择`Open the Web UI`，向导将自动启动服务并在浏览器中打开Web管理界面。

步骤七：配置大模型API（以阿里云百炼为例）

配置向导中或后续运行`openclaw onboard --add-model`可添加模型。按提示选择`Custom Provider`，填入API地址和Key。以阿里云百炼为例：

- API Base URL：`https://dashscope.aliyuncs.com/compatible-mode/v1`

- API Key：粘贴你在阿里云百炼平台创建的API Key

- Model ID：输入模型标识符，如`qwen-max`

系统将自动验证连接，显示`Verification successful`即表示配置成功。

步骤八：健康检查与启动

安装完成后务必运行诊断命令，确保环境正确：

openclaw doctor

如果所有检查项均为绿色，说明部署成功。手动启动服务：

openclaw gateway start

openclaw status    # 查看运行状态

步骤九：获取WebUI访问令牌

首次登录WebUI可能需要令牌：

openclaw token generate

复制生成的令牌，在浏览器中访问`http://你的服务器IP:18789`，输入令牌即可进入OpenClaw的Web管理界面。

三、常见故障排除

错误1：npm error code 128（Git克隆失败）

- 原因：Git未安装、版本过旧，或国内网络访问GitHub缓慢/超时。

- 解决：检查Git是否安装（`git --version`），未安装则执行`sudo apt install git -y`；或配置Git代理使用科学上网环境。

错误2：EACCES: permission denied（权限错误）

- 原因：当前用户无权限写入系统目录。

- 解决：在命令前加`sudo`，如`sudo npm install -g openclaw@latest`。

错误3：Node.js版本过低

- 原因：系统自带的Node.js版本低于22.x。

- 解决：使用NodeSource官方脚本安装最新22.x LTS版本。

错误4：无法访问WebUI（端口不通）

- 原因：服务器防火墙未开放18789端口。

- 解决：在云服务商控制台的安全组中，添加入站规则放行TCP端口18789。

错误5：API连接验证失败

- 原因：API Key错误、API地址不正确或网络不通。

- 解决：确认API Key正确且未过期；检查API Base URL是否以`/v1`结尾；确保服务器能正常访问该API域名。

四、为什么选择云服务器部署OpenClaw？

将OpenClaw部署在云服务器上，能充分发挥其“24/7全天候运行”的核心优势：

- 永不掉线：云服务器7×24小时在线，OpenClaw可随时响应指令、执行定时任务。

- 低硬件门槛：OpenClaw对算力要求极低，一台2核4G的云服务器即可流畅运行。

- 数据安全：所有配置文件、对话记录均存储在本地磁盘，数据完全归用户所有。

- 远程操控：通过配置Telegram、飞书等渠道，你可以在手机上随时向云服务器上的OpenClaw下达指令。

OpenClaw的部署并不复杂——只需一个支持Node.js 22+的环境、一条全局安装命令和一个交互式配置向导，就能让这个强大的AI代理在你的服务器上“安家”。无论是自动化处理文件、定时执行脚本，还是作为7×24小时的智能助手，OpenClaw都能胜任。

华纳云香港云服务器采用双向CN2 GIA精品线路，华南地区延迟可低至12-18ms，为远程SSH操作和WebUI访问提供流畅体验。2核4G起步的配置足以稳定运行OpenClaw及其扩展技能，是部署AI代理的理想选择。