# 宝塔面板一键安装 OpenClaw：史上最详细图文教程
## 前言
对于很多站长和技术爱好者来说，在服务器上部署应用一直是一个门槛较高的事情。宝塔面板（BT Panel）作为国内最流行的服务器管理面板之一，以其可视化的操作界面和丰富的功能，大大降低了服务器管理的难度。
而 OpenClaw 作为腾讯元宝推出的 AI Agent 平台，也支持通过宝塔面板进行一键安装部署。本文将详细介绍如何在宝塔面板上安装 OpenClaw，即使你是技术小白，也能轻松完成部署。
## 一、前置准备
### 1.1 服务器要求
在开始安装之前，请确保你的服务器满足以下最低配置要求：
- **CPU**：2 核以上（推荐 4 核）
- **内存**：4GB 以上（推荐 8GB）
- **硬盘**：40GB 以上
- **操作系统**：CentOS 7+ / Ubuntu 18.04+ / Debian 10+
- **网络**：公网 IP，可访问互联网
### 1.2 安装宝塔面板
如果你还没有安装宝塔面板，请先完成宝塔面板的安装。
**CentOS 系统安装命令：**
```bash
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh
```
**Ubuntu/Debian 系统安装命令：**
```bash
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
```
安装过程中会提示设置后台管理端口（默认 8888）和管理员账号密码，请妥善保管。
安装完成后，访问 `http://你的服务器IP:8888` 登录宝塔面板。
### 1.3 环境准备
登录宝塔面板后，系统会推荐安装 LNMP 或 LAMP 环境。选择推荐的 LNMP 环境安装（包含 Nginx、MySQL、PHP）。
**推荐安装配置：**
- Nginx：最新稳定版
- MySQL：8.0
- PHP：8.0 或更高
- phpMyAdmin：最新版本（用于数据库管理）
安装完成后，你的服务器就具备运行 OpenClaw 的基础环境了。
## 二、通过 Docker 安装 OpenClaw（推荐）
### 2.1 为什么推荐 Docker？
使用 Docker 安装 OpenClaw 有以下优势：
1. **环境隔离**：不影响服务器上其他网站
2. **部署简单**：一条命令完成安装
3. **易于迁移**：导出镜像即可迁移到其他服务器
4. **版本管理**：轻松升级和回滚
5. **资源可控**：可以限制容器资源使用
### 2.2 安装 Docker
在宝塔面板中安装 Docker：
**方法一：通过宝塔软件商店安装**
1. 登录宝塔面板
2. 点击左侧菜单「软件商店」
3. 搜索「Docker」
4. 点击「安装」
**方法二：通过命令行安装**
连接到服务器，执行以下命令：
```bash
# CentOS
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
# Ubuntu/Debian
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
# 启动 Docker
systemctl start docker
systemctl enable docker
```
安装完成后，运行以下命令验证：
```bash
docker --version
docker-compose --version
```
### 2.3 安装 OpenClaw
Docker 安装完成后，执行以下命令安装 OpenClaw：
```bash
# 创建 OpenClaw 工作目录
mkdir -p /www/openclaw
cd /www/openclaw
# 创建 docker-compose.yml 文件
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
restart: always
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- PORT=3000
volumes:
- ./data:/app/data
- ./logs:/app/logs
networks:
- openclaw-network
networks:
openclaw-network:
driver: bridge
EOF
# 启动容器
docker-compose up -d
# 查看运行状态
docker-compose ps
```
### 2.4 配置反向代理（可选但推荐）
为了让 OpenClaw 通过域名访问，我们需要配置 Nginx 反向代理。
**步骤一：创建网站**
1. 在宝塔面板中点击「网站」
2. 点击「添加站点」
3. 填写域名（如 openclaw.example.com）
4. 数据库选择「不创建」
5. PHP 版本选择「纯静态」
**步骤二：配置反向代理**
1. 点击刚才创建的网站
2. 点击「反向代理」
3. 点击「添加反向代理」
4. 填写以下信息：
- 代理名称：OpenClaw
- 目标 URL：`http://127.0.0.1:3000`
- 发送域名：$host
5. 点击「提交」
**步骤三：配置 SSL 证书**
1. 点击「SSL」
2. 选择「Let's Encrypt」或其他证书
3. 申请 SSL 证书
4. 开启「强制HTTPS」
配置完成后，访问 `https://openclaw.example.com` 即可使用 OpenClaw。
## 三、直接安装 OpenClaw（无 Docker）
### 3.1 安装 Node.js
OpenClaw 基于 Node.js 开发，需要先安装 Node.js 环境。
**方法一：通过 NVM 安装（推荐）**
```bash
# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载环境
source ~/.bashrc
# 安装 Node.js（推荐 LTS 版本）
nvm install --lts
# 验证安装
node --version
npm --version
```
**方法二：通过宝塔面板安装**
1. 在宝塔面板「软件商店」中搜索「Node.js版本管理器」
2. 安装后点击设置
3. 安装 Node.js 18 LTS 版本
4. 设置为默认版本
### 3.2 安装 OpenClaw
Node.js 安装完成后，执行以下命令安装 OpenClaw：
```bash
# 创建工作目录
mkdir -p /www/openclaw
cd /www/openclaw
# 克隆 OpenClaw 代码（如果是开源版本）
git clone https://github.com/openclaw/openclaw.git .
# 安装依赖
npm install
# 构建项目
npm run build
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置必要参数
nano .env
```
**.env 文件关键配置项：**
```bash
# 服务端口
PORT=3000
# 数据库配置（使用 SQLite 简化部署）
DATABASE_URL=file:./data/openclaw.db
# 管理员账号
ADMIN_EMAIL=your-email@example.com
ADMIN_PASSWORD=your-password
# JWT 密钥（使用随机字符串）
JWT_SECRET=your-random-secret-key
# 腾讯云配置（用于 AI 能力）
TENCENT_SECRET_ID=your-secret-id
TENCENT_SECRET_KEY=your-secret-key
```
### 3.3 初始化数据库
```bash
npm run db:init
```
### 3.4 配置 PM2 进程管理
使用 PM2 管理 OpenClaw 进程，实现开机自启和自动重启：
```bash
# 安装 PM2
npm install -g pm2
# 创建 PM2 配置文件
cat > ecosystem.config.js << 'EOF'
module.exports = {
apps: [{
name: 'openclaw',
script: 'npm',
args: 'start',
cwd: '/www/openclaw',
instances: 1,
autorestart: true,
watch: false,
max_memory_restart: '1G',
env: {
NODE_ENV: 'production',
PORT: 3000
}
}]
};
EOF
# 启动服务
pm2 start ecosystem.config.js
# 设置开机自启
pm2 startup
pm2 save
# 查看运行状态
pm2 status
```
访问 `http://你的服务器IP:3000` 即可使用 OpenClaw。
## 四、配置与优化
### 4.1 配置域名访问
通过 Nginx 配置域名反向代理（如前文所述），实现 HTTPS 访问。
### 4.2 配置防火墙
确保服务器防火墙开放以下端口：
```bash
# 开放 3000 端口（仅反向代理时需要）
sudo firewall-cmd --permanent --add-port=3000/tcp
# 重载防火墙
sudo firewall-cmd --reload
# 或使用宝塔面板的防火墙功能
```
### 4.3 配置 SSL 证书
使用 Let's Encrypt 免费证书：
```bash
# 安装 Certbot
sudo yum install certbot python-certbot-nginx -y
# 申请证书
sudo certbot --nginx -d openclaw.example.com
# 自动续期（Let's Encrypt 证书有效期 90 天）
sudo certbot renew --dry-run
```
### 4.4 性能优化
**内存优化：**
如果服务器内存较小，可以在 `.env` 中配置：
```bash
NODE_OPTIONS=--max-old-space-size=2048
```
**数据库优化：**
对于 SQLite 数据库，定期执行 VACUUM：
```bash
sqlite3 /www/openclaw/data/openclaw.db "VACUUM;"
```
**Nginx 优化：**
在 Nginx 配置文件中添加：
```nginx
# 开启 gzip 压缩
gzip on;
gzip_types text/plain text/css application/json application/javascript;
gzip_min_length 1000;
# 配置缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
```
## 五、备份与恢复
### 5.1 重要数据
需要备份的数据：
- `/www/openclaw/data/` - 数据库文件
- `/www/openclaw/.env` - 配置文件
- `/www/openclaw/logs/` - 日志文件（可选）
### 5.2 备份脚本
创建自动备份脚本：
```bash
#!/bin/bash
# backup_openclaw.sh
BACKUP_DIR=/www/backup/openclaw
DATE=$(date +%Y%m%d)
# 创建备份目录
mkdir -p $BACKUP_DIR
# 备份数据库
cp /www/openclaw/data/openclaw.db $BACKUP_DIR/openclaw_$DATE.db
# 备份配置
cp /www/openclaw/.env $BACKUP_DIR/env_$DATE
# 压缩备份
tar -czf $BACKUP_DIR/openclaw_backup_$DATE.tar.gz \
/www/openclaw/data \
/www/openclaw/.env
# 删除 30 天前的备份
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete
echo "Backup completed: $DATE"
```
添加到 crontab 定时执行：
```bash
# 每天凌晨 3 点执行备份
0 3 * * * /www/backup/backup_openclaw.sh >> /www/backup/backup.log 2>&1
```
### 5.3 恢复数据
```bash
# 解压备份
tar -xzf openclaw_backup_20260409.tar.gz
# 恢复数据库
cp openclaw_20260409.db /www/openclaw/data/openclaw.db
# 恢复配置
cp env_20260409 /www/openclaw/.env
# 重启服务
pm2 restart openclaw
```
## 六、常见问题解答
### Q1：安装后无法访问？
检查清单：
1. 防火墙是否开放了端口
2. Docker 容器是否正常运行：`docker ps`
3. 服务端口是否被占用：`netstat -tlnp | grep 3000`
4. 查看日志排查错误：`pm2 logs` 或 `docker logs openclaw`
### Q2：502 Bad Gateway 错误？
这是 Nginx 反向代理配置问题。检查：
1. OpenClaw 服务是否正在运行
2. Nginx 配置中的代理地址是否正确
3. Nginx 错误日志：`/www/server/nginx/logs/error.log`
### Q3：数据库连接失败？
1. 检查 SQLite 数据库文件是否存在
2. 检查文件权限：`chmod 755 /www/openclaw/data/`
3. 检查数据库文件权限：`chmod 644 /www/openclaw/data/openclaw.db`
### Q4：如何升级 OpenClaw？
Docker 方式：
```bash
cd /www/openclaw
docker-compose pull
docker-compose up -d
```
直接安装方式：
```bash
cd /www/openclaw
git pull
npm install
npm run build
pm2 restart openclaw
```
### Q5：如何查看运行日志？
Docker 方式：
```bash
docker logs -f openclaw
```
PM2 方式：
```bash
pm2 logs openclaw
```
## 七、安全加固
### 7.1 修改默认端口
编辑 `.env` 文件，修改端口：
```bash
PORT=8888
```
重启服务后，记得更新防火墙和 Nginx 配置。
### 7.2 配置登录验证码
在 `.env` 中开启登录验证码：
```bash
ENABLE_CAPTCHA=true
```
### 7.3 配置 IP 白名单
在 Nginx 配置中限制访问 IP：
```nginx
allow 1.2.3.4; # 你的 IP
allow 5.6.7.8; # 其他信任的 IP
deny all;
```
### 7.4 定期更新
定期检查并更新 OpenClaw 版本，确保安全漏洞被修复：
```bash
# 检查最新版本
npm outdated
# 更新到最新版本
npm update
pm2 restart openclaw
```
## 八、性能监控
### 8.1 使用 PM2 监控
```bash
pm2 monit
```
### 8.2 配置异常告警
在 PM2 配置中添加告警：
```json
{
"apps": [{
"name": "openclaw",
"script": "npm",
"args": "start",
"notify": true,
"error_file": "/www/openclaw/logs/err.log",
"out_file": "/www/openclaw/logs/out.log"
}]
}
```
### 8.3 宝塔面板监控
在宝塔面板「监控」中可以查看服务器资源使用情况。
## 九、总结
通过本文的详细教程，你应该已经掌握了在宝塔面板上安装和配置 OpenClaw 的全部方法。无论你选择 Docker 方式还是直接安装方式，都能成功部署 OpenClaw 并开始使用 AI Agent 的强大能力。
**关键步骤回顾：**
1. ✅ 准备满足条件的服务器
2. ✅ 安装宝塔面板和环境
3. ✅ 选择安装方式（Docker 推荐）
4. ✅ 配置反向代理和 SSL
5. ✅ 配置备份和安全加固
6. ✅ 监控和维护
如果在安装过程中遇到任何问题，欢迎在评论区留言，我会尽力帮助解答。祝你部署成功，享受 AI 带来的便利！
---
*本文基于 OpenClaw 最新版本撰写，安装步骤可能因版本更新而有所变化，请以官方文档为准。*
