OpenClaw 云服务器部署完整教程：基于阿里云 + 宝塔面板的生产环境搭建

2026-06-01 AI-Pick - 精选AI工具导航已浏览11次

OpenClaw 是一个开源自托管的 AI Agent 框架，可以运行在你的个人电脑或云服务器上，连接微信、钉钉、飞书、Discord 等 20+ 聊天平台。GitHub 已超 30 万星标。

将 OpenClaw 部署在云服务器上的最大优势是——它能够24 小时不间断运行，不依赖你的个人电脑。各类消息渠道的事件监听、定时任务、多终端共享等场景都更适合在云端运行。

本文将以阿里云 ECS + 宝塔面板为例，详细介绍生产环境部署的完整流程。

一、服务器选购与准备

1.1 最低配置要求

项目	推荐配置	最低配置
操作系统	Ubuntu 22.04+ / Debian 12+	CentOS Stream 9
Node.js	22.x 或更高	20.x
内存	4GB	2GB
磁盘	20GB SSD	10GB

1.2 服务器选购建议

国内用户：阿里云 ECS、腾讯云 CVM、华为云——国内访问低延迟
海外用户/需要访问国际 API：Hetzner（$5/月起）、DigitalOcean（$6/月起）
免费方案：Oracle Cloud ARM 永久免费实例（4核24GB）

1.3 端口放行

部署前需要在云服务器控制台的安全组中放行以下端口：

3000 — OpenClaw 网关（仅内网，不要公网暴露）
80 / 443 — Nginx 反向代理（如果有域名）
22 — SSH 连接

二、安装 Node.js 环境

OpenClaw 基于 Node.js 运行，官方推荐使用 Node.js 22.x 或更高版本。不推荐使用 Bun，因为其对某些 Node.js API 的兼容性不完整。

通过 SSH 连接到服务器后执行：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证版本
node --version # 应输出 v22.x.x
npm --version

国内加速：如果 npm 安装慢，建议配置国内镜像：

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

2.1 创建专用用户（安全最佳实践）

建议为 OpenClaw 创建独立的系统用户，避免使用 root 运行：

sudo adduser openclaw
sudo usermod -aG sudo openclaw
su - openclaw

三、安装 OpenClaw

3.1 全局安装

npm install -g openclaw

# 验证安装
openclaw --version

3.2 初始化配置

运行初始化引导，选择 AI 模型提供者并配置 API Key：

openclaw onboard

引导过程会：

选择 AI 模型提供者（如 Anthropic Claude、OpenAI GPT、通义千问 Qwen 等）
配置 API Key
生成配置文件到 ~/.config/openclaw/openclaw.json5

3.3 国内模型推荐

对于国内用户，推荐使用以下模型提供者以获得最佳延迟：

Provider	推荐模型	认证方式
通义千问 Qwen	qwen-max / qwen-plus	OAuth（免费额度）
MiniMax	M2.1 / M2.7	API Key
火山引擎/DeepSeek	DeepSeek-V3	API Key
小米 MiMo	MiMo	API Key（完全免费）
Kimi/Moonshot	kimi-latest	API Key（256K上下文）

四、性能优化：启动加速

低配 VPS（如 2GB 内存实例）首次启动较慢，可通过编译缓存大幅提升后续速度：

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc

NODE_COMPILE_CACHE：Node.js V8 编译缓存，首次运行后后续启动明显加快
OPENCLAW_NO_RESPAWN=1：禁止进程自重启，配合 systemd 使用

五、配置 systemd 守护进程

将 OpenClaw 注册为系统服务，实现开机自启和崩溃自动重启。

5.1 方法一：一键安装（推荐）

openclaw onboard daemon

此命令会自动创建 systemd 用户级服务单元并配置自动启动。

5.2 方法二：手动配置（适合自定义）

创建服务文件 /etc/systemd/system/openclaw.service：

[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
ExecStart=/usr/bin/openclaw gateway --port 18789
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Environment=OPENCLAW_NO_RESPAWN=1
Restart=on-failure
RestartSec=10
StartLimitBurst=5
StartLimitIntervalSec=60
User=openclaw

[Install]
WantedBy=multi-user.target

加载并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw

5.3 启用 lingering（关键步骤）

如果使用用户级 systemd 服务，需要启用 lingering 使用户级服务在退出登录后继续运行：

sudo loginctl enable-linger openclaw

六、安全远程访问

重要原则：OpenClaw 的网关绝不要直接绑定到 0.0.0.0 暴露到公网。以下是两种推荐的安全访问方式：

6.1 方式一：SSH 隧道（最安全）

在本地机器上执行：

ssh -L 18789:127.0.0.1:18789 user@你的服务器IP

之后在本地浏览器访问 http://127.0.0.1:18789/ 即可打开 OpenClaw 控制面板。

持久化 SSH 隧道（使用 autossh）：

sudo apt install autossh
autossh -M 0 -f -N -L 18789:127.0.0.1:18789 user@你的服务器IP

6.2 方式二：Tailscale 私有网络

安装 Tailscale 并在配置文件中指定绑定到 tailnet：

# 安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# 配置 OpenClaw 绑定 Tailscale
openclaw config set gateway.bind tailnet

配置后只有同一 Tailscale 网络内的设备可以访问，无需暴露任何公网端口。

6.3 使用宝塔面板 + Nginx 反向代理（如果你已有域名）

如果你已经有域名和宝塔面板，可以通过 Nginx 反向代理并配置 HTTPS 来安全访问：

在宝塔面板 → 网站 → 添加站点 → 设置反向代理：

目标 URL：http://127.0.0.1:18789
同时开启 SSL 证书
加上访问密码认证（宝塔面板自带功能）

七、健康检查与维护

7.1 诊断工具

OpenClaw 内置诊断工具 openclaw doctor，会检查：

Node.js 版本是否满足要求
配置文件是否有效
模型提供者连接状态
守护进程运行状况
端口占用情况

openclaw doctor # 执行诊断
openclaw doctor --fix # 自动修复

7.2 查看日志

journalctl --user -u openclaw-gateway -f # 实时查看日志
journalctl --user -u openclaw-gateway --no-pager -n 50 # 查看最近50行

7.3 更新 OpenClaw

npm update -g openclaw
sudo systemctl restart openclaw # 重启服务

7.4 版本更新频道

openclaw update --channel stable   # 稳定版（默认）
openclaw update --channel beta   # Beta 版
openclaw update --channel canary   # 每日构建版

八、常见问题

Q1：服务启动后立即退出怎么办？

查看 journalctl 日志定位原因。常见原因包括端口被占用、配置文件错误、模型 API Key 未配置等。

Q2：国内服务器无法访问国际 API 怎么办？

推荐使用国内模型提供者：通义千问 Qwen、MiniMax、火山引擎 DeepSeek 等，它们在国内有部署节点，延迟低且不需要特殊网络环境。

Q3：需要备份哪些数据？

定期备份 ~/.config/openclaw/ 配置目录和 workspace 目录，VPS 数据丢失无法恢复。

Q4：服务器内存不够怎么办？

如果只有 2GB 内存，建议配置 swap 交换分区：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

总结

本文详细介绍了在云服务器上部署 OpenClaw 生产环境的完整流程，包括环境搭建、性能优化、systemd 守护进程配置和安全远程访问。部署完成后，你拥有的是一个7×24 小时不间断运行的 AI Agent，可以随时通过手机或电脑与你互动。

相关资源：

OpenClaw 中文社区：https://openclaw.cn
官方文档：https://docs.openclaw.ai
技能市场：https://clawhub.ai
GitHub：https://github.com/openclaw/openclaw

→ 访问 OpenClaw 中文社区 → 收藏 AI Pick 导航站