Shell / BashNode.jsAI
OpenClaw 云服务器部署指南：镜像与手动方案
OpenClaw 开源自主智能体框架支持跨平台自动化任务。详解云服务器部署方案，包括应用镜像一键部署与 Linux 手动部署两种方式。内容涵盖系统要求、Node.js 环境配置、Swap 内存创建、服务化启动、防火墙及安全加固策略。同时提供 Nginx 反向代理配置示例及常见问题解决方案，助力用户快速搭建稳定运行的 AI 助手。
OpenClaw 开源自主智能体框架支持跨平台自动化任务。详解云服务器部署方案，包括应用镜像一键部署与 Linux 手动部署两种方式。内容涵盖系统要求、Node.js 环境配置、Swap 内存创建、服务化启动、防火墙及安全加固策略。同时提供 Nginx 反向代理配置示例及常见问题解决方案，助力用户快速搭建稳定运行的 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
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online