搬瓦工

OpenClaw 一键安装教程:VPS 服务器部署指南(2026 最新)

OpenClaw 是目前非常火的一个开源 AI 私人助手项目,可以部署在你自己的服务器上,通过 WhatsApp、Telegram、Discord 等聊天软件与它对话,让它帮你处理邮件、管理日历、控制浏览器,甚至自己写代码、部署网站。简单来说,就是在你的 VPS 上跑一个 7×24 小时在线的 AI 助手,随时可以给你干活。

本文面向新手用户,手把手教你在 VPS 服务器上完成 OpenClaw 的一键安装和基本配置,整个过程大概 10 分钟就能搞定。

一、OpenClaw 是什么

在正式开始之前,先简单介绍一下 OpenClaw 这个项目。

OpenClaw(前身叫 Clawdbot / Moltbot)是由开发者 Peter Steinberger 发起的开源项目,GitHub 上已经有超过 6 万颗星,MIT 许可证,完全免费。它的核心架构分为两个部分:一个是 Gateway(网关),负责消息的接收和转发;另一个是 Agent(智能体),负责调用 AI 模型来处理你的指令。

OpenClaw 支持接入多种 AI 模型,包括 Claude、GPT、Gemini 等,你可以根据自己的需求和预算来选择。同时它还支持 10 多个聊天平台,包括 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等。

为什么要部署在 VPS 上而不是本地电脑上?主要有以下几个原因:

对比项 本地电脑 VPS 服务器
在线时间 关机就断 7×24 小时在线
网络稳定性 受家庭网络影响 稳定可靠
远程访问 需要额外配置 天然支持
适合场景 测试体验 正式使用

所以如果你想让 OpenClaw 真正成为你的 AI 助手,部署在 VPS 上是更好的选择。

二、VPS 配置要求

在购买或者准备 VPS 之前,先确认一下配置是否满足要求。根据官方文档和社区实测,以下是不同场景下的配置建议:

配置项 最低要求 推荐配置
CPU 1 核 2 核
内存 1 GB(需添加 Swap) 2 GB 及以上
硬盘 10 GB 20 GB 及以上
操作系统 Ubuntu 22.04 / 24.04 Ubuntu 24.04 LTS
Node.js 22.12.0 及以上 最新 LTS 版本

这里要特别提醒一下:内存很重要。如果你的 VPS 只有 1 GB 内存,在安装过程中(尤其是 npm install 阶段)很可能会因为内存不足而失败。社区里很多人踩过这个坑,建议至少 2 GB 内存起步,或者给 1 GB 内存的机器添加 Swap 分区来应急。

三、安装前准备工作

假设你已经有了一台满足要求的 VPS(Ubuntu 系统),并且能通过 SSH 连上去。如果你还不会用 SSH 连接 VPS,可以使用 PuTTY(Windows)或者直接在终端(Mac / Linux)输入 ssh root@你的服务器IP 来连接。

连上之后,先做两件事。

1. 更新系统

登录 VPS 后,先更新一下系统软件包:

sudo apt update && sudo apt upgrade -y

这一步是好习惯,确保系统的软件包都是最新的,避免后续安装过程中出现依赖问题。

2. 添加 Swap(内存不足 2 GB 的必做)

如果你的 VPS 内存不足 2 GB,强烈建议先添加一个 Swap 分区。执行以下命令:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

执行完之后可以用 free -h 命令确认 Swap 是否已经生效。如果看到 Swap 那一行有数值了,就说明没问题。

四、一键安装 OpenClaw

准备工作做完了,下面就是正式安装环节了。OpenClaw 官网提供了一键安装命令,非常简单。

方式一:一键安装脚本(推荐新手使用)

这是最简单的安装方式,官方安装脚本会自动检测你的操作系统、安装 Node.js(如果缺少的话)、安装 OpenClaw,并启动引导向导。一行命令搞定:

curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动帮你处理好所有的依赖问题。如果你之前没有装过 Node.js,它也会帮你装好。装完之后会自动进入 onboard(引导)流程。

如果你想先看看脚本内容再执行(安全习惯),可以这样做:

curl -fsSL https://openclaw.ai/install.sh -o install.sh
cat install.sh  # 查看脚本内容
bash install.sh  # 确认没问题后再执行

方式二:npm 全局安装

如果你已经有 Node.js 22 及以上版本的环境,也可以直接通过 npm 安装:

npm install -g openclaw

安装完成后手动启动引导向导:

openclaw onboard

方式三:从源码安装(适合想折腾的用户)

如果你喜欢从源码编译,可以使用 hackable 模式安装:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

或者完全手动克隆仓库:

git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build

三种安装方式的对比如下:

安装方式 难度 适合人群 更新方式
一键脚本 简单 新手用户 重新运行脚本
npm 安装 中等 有 Node.js 基础 npm update -g openclaw
源码安装 较高 开发者 git pull + 重新编译

对于大多数新手用户,直接用方式一就可以了,省心省力。

五、onboard 引导配置

不管你用哪种方式安装,安装完成后都需要运行一次引导向导。如果安装脚本没有自动启动引导,你可以手动运行:

openclaw onboard

引导过程中会让你配置以下几项内容:

第一步:选择 AI 模型提供商。 OpenClaw 支持 Anthropic(Claude)、OpenAI(GPT)、Google(Gemini)等多家模型。你需要选择一个,并填入对应的 API Key。如果你还没有 API Key,需要先去对应平台的官网注册并获取。

第二步:选择聊天渠道。 也就是你打算用什么聊天软件和 OpenClaw 对话。比如选择 Telegram,它会引导你创建一个 Telegram Bot 并完成关联;选择 WhatsApp,则需要扫描二维码完成绑定。

第三步:配置技能(Skills)。 OpenClaw 通过 Skills 来扩展功能,比如浏览器控制、文件管理、Shell 命令执行等。引导过程中可以选择安装一些基础技能,后续也可以随时添加。

第四步:安装守护进程(Daemon)。 这一步会把 OpenClaw 注册为系统服务,确保 VPS 重启后它也能自动启动。在 Linux 上使用的是 systemd 来管理。

引导完成后,OpenClaw 就已经在你的 VPS 上跑起来了。

六、安装后的验证

安装完成后,可以通过以下几个命令来确认一切正常:

# 查看 OpenClaw 版本
openclaw --version

# 运行健康检查
openclaw doctor

# 查看 Gateway 运行状态
systemctl --user status openclaw-gateway

# 查看实时日志
openclaw logs --follow

如果 openclaw doctor 没有报错,并且 Gateway 状态显示为 running,那就说明安装成功了。

七、访问控制面板

OpenClaw 安装完成后会提供一个 Web 控制面板(Control UI),默认监听在 localhost:18789

因为 VPS 上一般不建议直接把这个端口暴露到公网(安全问题),所以需要通过 SSH 隧道来访问。在你本地电脑的终端中执行:

ssh -L 18789:localhost:18789 root@你的服务器IP

然后在本地浏览器中打开 http://localhost:18789,就能看到 OpenClaw 的控制面板了。控制面板里可以管理会话、查看日志、配置技能等。

注意: 第一次访问控制面板时需要输入安全令牌(Token),这个令牌在 onboard 引导过程中会生成。如果忘记了,可以运行 openclaw dashboard 命令重新获取。

八、常见问题

在安装过程中可能会遇到一些问题,这里整理了几个最常见的:

问题 原因 解决方法
npm install 时报 heap out of memory 内存不足 添加 Swap 或升级到 2 GB 内存
Gateway 启动失败 API Key 配置错误 运行 openclaw onboard 重新配置
控制面板打不开 端口未正确转发 检查 SSH 隧道命令是否正确
提示 Node.js 版本过低 Node.js 版本低于 22 升级 Node.js 到 22 或以上
连接聊天平台失败 网络问题或配置错误 检查网络连通性和渠道配置

如果遇到其他问题,可以运行 openclaw doctor 进行诊断,或者到 OpenClaw 的 Discord 社区寻求帮助。

九、日常维护

OpenClaw 安装好之后,日常维护其实很简单,主要就是以下几件事。

更新 OpenClaw: 如果你是用一键脚本安装的,直接重新运行安装脚本即可。如果是 npm 安装的,执行 npm update -g openclaw

重启 Gateway: 如果遇到异常,可以重启 Gateway 服务:

openclaw gateway restart

查看日志: 排查问题时最有用的就是看日志:

# 实时查看日志
openclaw logs --follow

# 通过 systemd 查看日志
journalctl --user -u openclaw-gateway -f

备份配置: OpenClaw 的所有配置和数据都保存在 ~/.openclaw/ 目录下,建议定期备份这个目录。

十、总结

本文介绍了在 VPS 上部署 OpenClaw 的完整流程,从准备工作到一键安装,再到引导配置和日常维护,应该能帮你顺利把 OpenClaw 跑起来。

整个安装流程概括下来就是三步:

  1. 准备一台 2 GB 内存以上、Ubuntu 系统的 VPS
  2. SSH 登录后运行 curl -fsSL https://openclaw.ai/install.sh | bash
  3. 按照引导完成 AI 模型和聊天渠道的配置

OpenClaw 这个项目目前还在快速迭代中,功能更新很频繁,社区也很活跃。如果你对 AI 助手感兴趣,这个项目值得一试。

相关链接:

下面的优惠通知只会在有优惠活动的时候推送信息,其他时候都是禁言的,所以不会对大家造成打扰,可以放心关注。

搬瓦工新手入门

  1. 搬瓦工新手入门教程(1):搬瓦工众多方案怎么选择
  2. 搬瓦工新手入门教程(2):搬瓦工机房选择和速度测试
  3. 搬瓦工新手入门教程(3):注册账户和微信支付、支付宝购买教程
  4. 搬瓦工新手入门教程(4):登陆搬瓦工网站后台查看 VPS,登录 KiwiVM 面板进行简单管理
  5. 搬瓦工新手入门教程(5):通过 KiwiVM 后台面板更换操作系统并获取登陆信息

搬瓦工优惠套餐

方案内存CPU硬盘流量/月带宽机房价格购买
KVM
(最便宜)
1GB2核20GB1TB1GbpsDC3 CN2
DC8 ZNET
$49.99/年购买
KVM2GB3核40GB2TB1Gbps$52.99/半年
$99.99/年
购买
CN2GIA-E
(最推荐)
1GB2核20GB1TB2.5GbpsDC6 CN2 GIA-E
DC9 CN2 GIA
日本软银 JPOS_1
荷兰 EUNL_9
$49.99/季度
$169.99/年
购买
CN2GIA-E2GB3核40GB2TB2.5Gbps$89.99/季度
$299.99/年
购买
HK2GB2核40GB0.5TB1Gbps中国香港 CN2 GIA
日本东京 CN2 GIA
$89.99/月
$899.99/年
购买
HK4GB4核80GB1TB1Gbps$155.99/月
$1559.99/年
购买
OSAKA2GB2核40GB0.5TB1.5Gbps日本大阪 CN2 GIA$49.99/月
$499.99/年
购买
OSAKA4GB4核80GB1TB1.5Gbps$86.99/月
$869.99/年
购买

此外,也可以参考《2025年最新搬瓦工优惠码/搬瓦工便宜套餐/搬瓦工新手教程整理》。

退出移动版