2026-03-29 07:28

在Linux服务器上部署OpenClaw：从零开始的完整指南

最近很多朋友问我如何在Linux服务器上部署OpenClaw，作为一个长期使用开源工具的老玩家，我决定写一篇详细的教程，分享我的部署经验。无论你是刚接触Linux的新手，还是有一定经验的开发者，这篇指南都能帮你顺利完成部署。

为什么选择服务器部署？

在开始之前，我们先聊聊为什么要在服务器上部署OpenClaw。与本地部署相比，服务器部署有几个明显优势：

24小时在线：你的AI助手随时可用
多设备访问：可以在手机、电脑、平板等多个设备上使用
性能更稳定：服务器通常有更好的硬件配置
数据更安全：专业的数据中心比个人设备更可靠

如果你还没有合适的服务器，我推荐考虑雨云的VPS。他们的性价比很高，特别适合运行OpenClaw这类应用。我自己的测试环境就放在雨云上，稳定性相当不错。

准备工作

1. 服务器选择

对于OpenClaw，我建议选择以下配置：

CPU：2核以上
内存：4GB以上
硬盘：20GB以上
系统：Ubuntu 22.04 LTS（最稳定）

如果你需要海外服务器，RackNerd是个不错的选择。他们的美国节点速度很快，价格也很实惠。

2. 系统更新

首先登录你的服务器，进行系统更新：

# 更新软件包列表
sudo apt update

# 升级已安装的软件包
sudo apt upgrade -y

# 安装必要的工具
sudo apt install -y curl wget git vim

安装Docker和Docker Compose

OpenClaw推荐使用Docker部署，这样最方便也最稳定。

安装Docker

# 卸载旧版本（如果有）
sudo apt remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt install -y ca-certificates curl gnupg lsb-release

# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 验证安装
sudo docker run hello-world

安装Docker Compose

# 下载最新版本的Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

部署OpenClaw

1. 创建工作目录

# 创建OpenClaw工作目录
mkdir -p ~/openclaw
cd ~/openclaw

2. 下载配置文件

# 下载docker-compose.yml配置文件
curl -o docker-compose.yml https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml

# 下载环境变量示例文件
curl -o .env.example https://raw.githubusercontent.com/openclaw/openclaw/main/.env.example

# 复制为正式环境文件
cp .env.example .env

3. 配置环境变量

编辑.env文件，根据你的需求进行配置：

# 使用vim编辑（也可以用nano）
vim .env

主要需要修改的配置：

OPENCLAW_HOSTNAME：你的域名或服务器IP
OPENCLAW_SECRET_KEY：生成一个安全的密钥
其他配置保持默认即可

对于国内用户，如果访问GitHub较慢，可以考虑使用腾讯云的云服务器。他们的国内节点访问GitHub速度会快很多，部署过程会更顺畅。

4. 启动OpenClaw

# 启动服务
docker-compose up -d

# 查看运行状态
docker-compose ps

# 查看日志
docker-compose logs -f

如果一切正常，你应该能看到OpenClaw成功启动的信息。

配置反向代理（可选但推荐）

为了让OpenClaw可以通过域名访问，我建议配置Nginx反向代理。

安装Nginx

sudo apt install -y nginx

创建Nginx配置文件

sudo vim /etc/nginx/sites-available/openclaw

添加以下内容（替换your-domain.com为你的域名）：

server {
    listen 80;
    server_name your-domain.com;
  
    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

启用配置

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重启Nginx
sudo systemctl restart nginx

访问和初始化

现在你可以通过浏览器访问你的OpenClaw了：

如果配置了域名：http://your-domain.com
如果使用IP：http://服务器IP:3000

首次访问时，OpenClaw会引导你完成初始化设置：

创建管理员账户
配置基本设置
安装初始技能

常见问题解决

1. 端口被占用

如果3000端口被占用，可以修改docker-compose.yml中的端口映射：

ports:
  - "3001:3000"  # 改为其他端口

2. 内存不足

如果服务器内存较小，可以调整Docker资源限制：

# 编辑docker-compose.yml
vim docker-compose.yml

# 在services部分添加资源限制
services:
  openclaw:
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 1G

对于资源有限的用户，野草云和DPNET都有很实惠的入门套餐，特别适合学习和测试使用。

3. 数据备份

定期备份你的数据很重要：

# 备份数据库
docker exec openclaw-db pg_dump -U openclaw openclaw > backup.sql

# 备份配置文件
tar -czf openclaw-config-backup.tar.gz ~/openclaw/

进阶配置

1. 启用HTTPS

使用Let"s Encrypt免费SSL证书：

# 安装Certbot
sudo apt install -y certbot python3-certbot-nginx

# 获取证书
sudo certbot --nginx -d your-domain.com

2. 设置自动更新

创建自动更新脚本：

vim ~/update-openclaw.sh

添加内容：

#!/bin/bash
cd ~/openclaw
docker-compose pull
docker-compose up -d
docker system prune -f

设置定时任务：

# 编辑crontab
crontab -e

# 添加每周日凌晨3点更新
0 3 * * 0 /bin/bash ~/update-openclaw.sh

结语

部署OpenClaw的过程可能看起来有些复杂，但一旦完成，你会发现这一切都是值得的。拥有一个完全由自己控制的AI助手，那种感觉真的很不一样。

我建议在部署过程中保持耐心，遇到问题多查资料。OpenClaw的社区很活跃，GitHub上的Issues区有很多解决方案。如果你在部署过程中遇到任何问题，欢迎在评论区留言，我会尽力帮你解决。

最后提醒一下，服务器安全很重要。记得定期更新系统、修改默认密码、配置防火墙。安全稳定的环境才能让你的OpenClaw长期稳定运行。

祝部署顺利！