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 跑起来。
整个安装流程概括下来就是三步:
- 准备一台 2 GB 内存以上、Ubuntu 系统的 VPS
- SSH 登录后运行
curl -fsSL https://openclaw.ai/install.sh | bash - 按照引导完成 AI 模型和聊天渠道的配置
OpenClaw 这个项目目前还在快速迭代中,功能更新很频繁,社区也很活跃。如果你对 AI 助手感兴趣,这个项目值得一试。
相关链接:
- OpenClaw 官网:
- GitHub 仓库:
- 官方文档:
下面的优惠通知只会在有优惠活动的时候推送信息,其他时候都是禁言的,所以不会对大家造成打扰,可以放心关注。
- 优惠通知(禁言,仅推送通知):1060173511
- 邮件通知(第一时间推送补货):提交邮箱地址
- 搬瓦工官网:点击直达
- 搬瓦工实时库存监控:kucun.banwagong.net
搬瓦工新手入门
- 搬瓦工新手入门教程(1):搬瓦工众多方案怎么选择
- 搬瓦工新手入门教程(2):搬瓦工机房选择和速度测试
- 搬瓦工新手入门教程(3):注册账户和微信支付、支付宝购买教程
- 搬瓦工新手入门教程(4):登陆搬瓦工网站后台查看 VPS,登录 KiwiVM 面板进行简单管理
- 搬瓦工新手入门教程(5):通过 KiwiVM 后台面板更换操作系统并获取登陆信息
搬瓦工优惠套餐
| 方案 | 内存 | CPU | 硬盘 | 流量/月 | 带宽 | 机房 | 价格 | 购买 |
|---|---|---|---|---|---|---|---|---|
| KVM (最便宜) | 1GB | 2核 | 20GB | 1TB | 1Gbps | DC3 CN2 DC8 ZNET | $49.99/年 | 购买 |
| KVM | 2GB | 3核 | 40GB | 2TB | 1Gbps | $52.99/半年 $99.99/年 | 购买 | |
| CN2GIA-E (最推荐) | 1GB | 2核 | 20GB | 1TB | 2.5Gbps | DC6 CN2 GIA-E DC9 CN2 GIA 日本软银 JPOS_1 荷兰 EUNL_9 | $49.99/季度 $169.99/年 | 购买 |
| CN2GIA-E | 2GB | 3核 | 40GB | 2TB | 2.5Gbps | $89.99/季度 $299.99/年 | 购买 | |
| HK | 2GB | 2核 | 40GB | 0.5TB | 1Gbps | 中国香港 CN2 GIA 日本东京 CN2 GIA | $89.99/月 $899.99/年 | 购买 |
| HK | 4GB | 4核 | 80GB | 1TB | 1Gbps | $155.99/月 $1559.99/年 | 购买 | |
| OSAKA | 2GB | 2核 | 40GB | 0.5TB | 1.5Gbps | 日本大阪 CN2 GIA | $49.99/月 $499.99/年 | 购买 |
| OSAKA | 4GB | 4核 | 80GB | 1TB | 1.5Gbps | $86.99/月 $869.99/年 | 购买 |
此外,也可以参考《2025年最新搬瓦工优惠码/搬瓦工便宜套餐/搬瓦工新手教程整理》。
未经允许不得转载:搬瓦工 » OpenClaw 一键安装教程:VPS 服务器部署指南(2026 最新)
搬瓦工
