OpenClaw在云服务器上搭建完整教程
引言
OpenClaw是一个功能强大的个人助理系统，能够帮助你管理日常任务、查询信息、自动化工作流等。随着云计算的普及，越来越多的用户选择在云服务器上搭建个人服务，这样可以实现24小时不间断运行，不受本地设备限制，同时也能更好地保护数据隐私。在云服务器上搭建OpenClaw，你可以随时随地通过网页或移动端访问你的个人助理，享受更加便捷智能的服务体验。本文将详细介绍在云服务器上搭建OpenClaw的完整过程。
本文服务器环境由 云基阁IDC 提供，香港CN2线路云服务器，稳定高速，适合搭建各类应用服务。
环境准备
在开始安装之前，我们需要准备一个合适的云服务器环境。推荐使用以下配置：
- 操作系统：Ubuntu 20.04 LTS 或 CentOS 8
- 内存：至少2GB（建议4GB以上）
- 存储空间：20GB以上
- 网络：需要开放80、443端口
首先，更新系统包并安装必要工具：
apt update && apt upgrade -y
apt install -y curl wget git vim ufw安装Node.js环境（OpenClaw需要Node.js 18以上版本）：
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs验证安装：
node --version
npm --version安装步骤
-
创建专用用户（推荐）：
adduser openclaw
usermod -aG sudo openclaw
-
切换到新用户并创建工作目录：
su - openclaw
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw
-
克隆OpenClaw项目：
git clone https://github.com/openclaw/openclaw.git .
npm install
-
安装PM2进程管理器：
npm install -g pm2
-
创建配置文件：
cp config.example.json config.json
vim config.json
在配置文件中，主要修改以下参数：
{
"port": 3000,
"host": "0.0.0.0",
"db": {
"path": "./data/database.sqlite"
},
"security": {
"secret": "your-random-secret-key-here"
}
}-
创建数据目录：
mkdir -p data logs
-
使用PM2启动OpenClaw：
pm2 start server.js --name "openclaw"
pm2 startup
pm2 save
配置优化
- Nginx反向代理配置：
sudo apt install -y nginx
sudo vim /etc/nginx/sites-available/openclaw
添加以下内容：
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
sudo systemctl restart nginx-
配置SSL证书（使用Let's Encrypt）：
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
-
配置UFW防火墙：
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 22/tcp
sudo ufw enable
-
优化PM2配置：
pm2 delete openclaw
pm2 start server.js --name "openclaw" --env production --max-memory-restart 1G
测试验证
-
检查服务状态：
pm2 status
pm2 logs openclaw --lines 100
-
验证端口监听：
netstat -tuln | grep 3000
-
浏览器访问测试：打开浏览器，访问 http://your-domain.com 或 https://your-domain.com，应该能看到OpenClaw的登录界面。
-
API测试：
curl -X GET http://localhost:3000/api/status
应该返回：
{"status":"ok","version":"x.x.x"}常见问题
1. 安装时提示Node.js版本过低
解决方法：按照环境准备部分的命令，使用NodeSource安装Node.js 20版本。
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs2. 启动后无法访问，端口被占用
检查端口占用：
lsof -i :3000
netstat -tuln | grep 3000如果端口被占用，可以修改config.json中的端口号，或者停止占用端口的服务。
3. PM2进程频繁重启
查看日志定位问题：
pm2 logs openclaw --lines 500常见原因是内存不足，可以尝试增加交换空间：
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/fstab4. 数据库权限问题
如果出现数据库无法写入的错误：
chown -R openclaw:openclaw ~/.openclaw/data
chmod -R 755 ~/.openclaw/data5. 自动启动失败
重新生成PM2启动脚本：
pm2 startup
按照输出提示执行生成的命令
pm2 save
6. 更新OpenClaw版本
停止服务后更新：
pm2 stop openclaw
cd ~/.openclaw
git pull origin main
npm install
pm2 start openclaw
pm2 save结语
通过以上步骤，你应该已经成功在云服务器上搭建了OpenClaw个人助理系统。现在你可以开始使用这个强大的工具来管理你的日常任务、查询信息和自动化工作流了。随着使用的深入，你会发现OpenClaw的插件系统和自定义功能非常强大，可以根据自己的需求进一步扩展功能。如果在搭建过程中遇到任何问题，欢迎到OpenClaw的GitHub仓库提交issue或查看已有的解决方案。