OpenClaw 云服务器部署与配置指南
在云服务器上部署 OpenClaw 开源智能体框架的完整流程。内容涵盖两种部署方式:基于云厂商镜像的一键部署和 Linux 手动部署。文章提供了详细的系统要求、环境配置(Node.js、Swap)、安装步骤、Nginx 反向代理配置及防火墙设置。此外,还包含安全加固建议、常见问题排查及后续优化方案,帮助用户实现 7x24 小时在线的 AI 助手服务。

在云服务器上部署 OpenClaw 开源智能体框架的完整流程。内容涵盖两种部署方式:基于云厂商镜像的一键部署和 Linux 手动部署。文章提供了详细的系统要求、环境配置(Node.js、Swap)、安装步骤、Nginx 反向代理配置及防火墙设置。此外,还包含安全加固建议、常见问题排查及后续优化方案,帮助用户实现 7x24 小时在线的 AI 助手服务。

适用版本: OpenClaw v2026.x | 难度: 中级 | 预计耗时: 15-30 分钟
OpenClaw 是一个开源的自主智能体(Autonomous Agent)框架,支持通过自然语言指令执行跨平台自动化任务。相比本地部署,云服务器部署可实现:
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 1 核 | 2 核+ |
| 内存 | 2 GB | 4 GB |
| 存储 | 20 GB SSD | 40 GB+ NVMe |
| 系统 | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
| Node.js | v22+ | v22 LTS |
适用于阿里云、百度云等提供 OpenClaw 镜像的厂商:
点击「打开网站页面」,输入生成的 Token,即可进入 OpenClaw Web 对话界面。
适用于 AWS、Hetzner、Vultr 等裸机服务器,或希望自定义配置的用户。
连接服务器:
# 修改密钥文件权限(如使用 SSH 密钥)
chmod 600 ~/Downloads/your-key.pem
# 连接(以 Ubuntu 为例)
ssh -i ~/Downloads/your-key.pem ubuntu@你的服务器公网IP
创建 Swap 内存(关键步骤): 2GB 内存直接安装可能因 OOM 导致卡死,建议创建 4GB Swap:
# 创建 Swap 文件
fallocate -l 4G ~/swapfile
chmod 600 ~/swapfile
sudo mkswap ~/swapfile
# 永久挂载
echo "$HOME/swapfile none swap sw 0 0" | sudo tee -a /etc/fstab
sudo swapon --all
# 验证
free -h
安装 Node.js 22+:
# 使用 nvm 安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
source ~/.bashrc
nvm install node
# 验证版本
node --version # 应显示 v22.x.x
安装系统依赖:
sudo apt update && sudo apt upgrade -y
sudo apt install -y libatomic1 # 解决 libatomic.so.1 缺失问题
方式一:一键脚本(推荐):
curl -fsSL https://openclaw.ai/install.sh | bash
方式二:npm 安装:
npm install -g openclaw@latest # 或使用 pnpm(内存占用更低)
# pnpm add -g openclaw@latest
运行引导向导:
openclaw onboard --install-daemon
按提示完成配置:
QuickStartkimi-k2.5-free(速率限制较严)yes 以安装 systemd 服务飞书接入示例:
App ID 和 App Secret--install-daemon 参数会自动创建 systemd 服务。验证状态:
# 查看服务状态
systemctl --user status openclaw
# 设置开机自启(关键命令)
sudo loginctl enable-linger $USER
手动创建服务(如需要):
# 创建服务文件
mkdir -p ~/.config/systemd/user/
cat > ~/.config/systemd/user/openclaw.service <<'EOF'
[Unit]
Description=OpenClaw Agent
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/openclaw gateway
Restart=always
RestartSec=10
[Install]
WantedBy=default.target
EOF
# 重载并启动
systemctl --user daemon-reload
systemctl --user enable --now openclaw
开放必要端口:
18789/tcp:Web 控制面板(如需外网访问)80/443:HTTP/HTTPS(如配置 Nginx 反向代理)# UFW 配置示例
sudo ufw allow 18789/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
server {
listen 443 ssl http2;
server_name openclaw.yourdomain.com;
ssl_certificate /etc/nginx/ssl/cert.pem;
ssl_certificate_key /etc/nginx/ssl/key.pem;
location / {
proxy_pass http://127.0.0.1:18789;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# WebSocket 支持(关键)
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
创建非 root 用户运行:
sudo adduser claw
sudo usermod -aG sudo claw
su - claw
使用加密 Vault 存储密钥:
openclaw vault set ANTHROPIC_API_KEY sk-ant-...
openclaw vault set TELEGRAM_BOT_TOKEN 123456:ABC...
启用配对模式(防止未授权访问):
# ~/.openclaw/config.yaml
channels:
telegram:
dmPolicy: pairing
allowlist:
- your_telegram_id
绑定本地地址(防止直接暴露管理端口):
openclaw gateway --bind 127.0.0.1
| 问题现象 | 原因 | 解决方案 |
|---|---|---|
npm install 卡死/无响应 | 内存不足 OOM | 检查 Swap 配置 free -h,关闭其他进程,或使用 pnpm |
libatomic.so.1 缺失 | 系统库未安装 | sudo apt install -y libatomic1 |
| SSH 权限错误 | 密钥文件权限过宽 | chmod 600 ~/Downloads/your-key.pem |
| Web 界面无法访问 | 防火墙未放行 | 检查安全组规则,确认 18789 端口开放 |
| API Key 无效 | 环境变量未传递 | 检查 Docker 或 systemd 服务的环境变量配置 |
| 服务无法开机自启 | linger 未启用 | 执行 sudo loginctl enable-linger $USER |
~/.openclaw/ 目录下的配置和 Vault 文件监控与日志:
# 查看实时日志
openclaw logs --tail 100
# 查看警告级别以上日志
openclaw logs --level warn
通过云服务器部署 OpenClaw,你可以获得一个永不离线的 AI 助手,无论是作为个人效率工具还是团队客服支持都非常适用。对于新手,推荐使用阿里云/百度云的应用镜像一键部署;对于有运维经验的用户,手动部署在 AWS/Hetzner 上能获得更高的性价比和灵活性。
部署时请注意 API 密钥安全,建议先在测试环境验证配置。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online