部署与 Docker
约 1961 字大约 7 分钟
2026-03-02
部署方式选择
OpenClaw 支持多种部署方式,可根据实际需求选择:
| 部署方式 | 优势 | 劣势 | 适用场景 |
|---|---|---|---|
| 本地部署 | 运行速度快、数据私有化、无服务器费用 | 需要备用主机、存在权限风险 | 有闲置电脑、对数据隐私要求高 |
| Docker 部署 | 环境隔离、易于迁移、配置简单 | 需要 Docker 基础知识 | 开发测试、快速部署 |
| 云端部署 | 7×24 小时运行、配置灵活、无本地设备占用 | 需支付服务器费用 | 生产环境、团队协作 |
入门推荐:优先选择云端部署,成本低、操作简单、稳定性高。
本地部署
环境要求
- Node.js ≥ 22.0.0
- 内存 ≥ 4GB
- 磁盘空间 ≥ 2GB
安装步骤
- 安装 OpenClaw:
npm install -g openclaw@latest- 初始化配置:
openclaw onboard --install-daemon- 启动服务:
openclaw gateway --port 18789详细步骤请参考 安装指南。
Docker 部署
前置准备
安装 Docker:
# Linux
curl -fsSL https://get.docker.com | sh
# macOS
brew install docker
# Windows
# 下载 Docker Desktop: https://www.docker.com/products/docker-desktop使用官方镜像
快速启动
docker run -d \
--name openclaw \
-p 18789:18789 \
-e NODE_OPTIONS="--max-old-space-size=4096" \
ghcr.io/openclaw/openclaw:latest持久化数据
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
-e NODE_OPTIONS="--max-old-space-size=4096" \
ghcr.io/openclaw/openclaw:latest使用 Docker Compose
创建 docker-compose.yml:
version: '3.8'
services:
openclaw:
image: ghcr.io/openclaw/openclaw:latest
container_name: openclaw
ports:
- "18789:18789"
volumes:
- ~/.openclaw:/root/.openclaw
environment:
- NODE_OPTIONS=--max-old-space-size=4096
- TZ=Asia/Shanghai
restart: unless-stopped启动服务:
docker-compose up -d自定义构建
创建 Dockerfile:
FROM node:22-alpine
WORKDIR /app
RUN npm install -g openclaw@latest
EXPOSE 18789
CMD ["openclaw", "gateway", "--port", "18789"]构建并运行:
docker build -t my-openclaw .
docker run -d -p 18789:18789 my-openclaw云端部署
腾讯云轻量应用服务器(推荐)
1. 购买服务器
选择配置:
- 地域:国内模型选国内地域,国外模型选海外地域
- 镜像:选择「OpenClaw 镜像」(如有)或「Ubuntu 22.04」
- 套餐:2核2G(基础任务)或 2核4G(复杂任务)
- 时长:按需选择(新用户有优惠)
完成支付,等待服务器初始化(约 1-2 分钟)
2. 连接服务器
方式 1:使用控制台
- 在服务器列表中点击「登录」
- 使用浏览器 SSH 终端
方式 2:使用 SSH 客户端
ssh root@your-server-ip3. 安装 OpenClaw
如果使用 OpenClaw 镜像,跳过此步骤。
# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt-get install -y nodejs
# 安装 OpenClaw
npm install -g openclaw@latest
# 初始化配置
openclaw onboard --install-daemon4. 配置防火墙
在腾讯云控制台「防火墙」中添加规则:
- 协议:TCP
- 端口:18789
- 来源:0.0.0.0/0(或限制特定 IP)
5. 启动服务
# 启动 Gateway
openclaw gateway --daemon
# 查看状态
openclaw status6. 配置域名(可选)
- 在腾讯云购买域名
- 添加 A 记录指向服务器 IP
- 配置 Nginx 反向代理:
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:18789;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}阿里云 ECS
1. 购买 ECS 实例
访问阿里云 ECS
选择配置:
- 地域:就近选择
- 实例规格:ecs.t6-c1m2.large(2核2G)
- 镜像:Ubuntu 22.04
- 网络:按需选择带宽
完成购买
2. 配置安全组
在 ECS 控制台「安全组」中添加入方向规则:
- 端口范围:18789/18789
- 授权对象:0.0.0.0/0
3. 安装部署
参考腾讯云的安装步骤。
AWS EC2
1. 创建 EC2 实例
- 登录 AWS 控制台
- 选择 EC2 服务
- 启动实例:
- AMI:Ubuntu Server 22.04 LTS
- 实例类型:t3.small(2核2G)
- 配置安全组:开放 18789 端口
2. 连接实例
ssh -i your-key.pem ubuntu@your-instance-ip3. 安装部署
参考腾讯云的安装步骤。
使用 OpenClaw 镜像(腾讯云)
腾讯云提供了预配置的 OpenClaw 镜像,可以快速部署。
1. 选择镜像
在购买服务器时,选择「应用镜像」→「OpenClaw」
2. 访问应用管理
服务器启动后:
- 在控制台点击「应用管理」
- 进入 OpenClaw 配置界面
3. 配置模型
在「模型」模块:
- 选择 AI 模型(如阿里千问 Qwen 3.5 Plus)
- 点击「获取 API KEY」跳转到模型平台
- 创建并复制 API Key
- 粘贴到配置框,点击「应用」
4. 配置渠道
在「通道」模块:
- 选择渠道类型(如飞书)
- 输入渠道凭证(App ID、App Secret)
- 点击「添加并应用」
5. 验证部署
在对应的 IM 工具中测试机器人是否正常响应。
生产环境配置
使用 Systemd 管理服务
创建服务文件 /etc/systemd/system/openclaw.service:
[Unit]
Description=OpenClaw AI Agent
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/root
ExecStart=/usr/bin/openclaw gateway --port 18789
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target启用服务:
systemctl enable openclaw
systemctl start openclaw
systemctl status openclaw使用 PM2 管理进程
安装 PM2:
npm install -g pm2启动 OpenClaw:
pm2 start openclaw -- gateway --port 18789
pm2 save
pm2 startup配置 Nginx 反向代理
安装 Nginx:
apt-get install nginx配置文件 /etc/nginx/sites-available/openclaw:
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:18789;
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;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}启用配置:
ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx配置 HTTPS
使用 Let's Encrypt 免费证书:
# 安装 Certbot
apt-get install certbot python3-certbot-nginx
# 获取证书
certbot --nginx -d your-domain.com
# 自动续期
certbot renew --dry-run性能优化
调整 Node.js 内存
export NODE_OPTIONS="--max-old-space-size=4096"启用缓存
在配置文件中:
{
"cache": {
"enabled": true,
"type": "redis",
"host": "localhost",
"port": 6379
}
}使用 Redis
安装 Redis:
apt-get install redis-server配置 OpenClaw 使用 Redis:
{
"session": {
"store": "redis",
"redis": {
"host": "localhost",
"port": 6379
}
}
}监控与日志
查看日志
# 实时日志
openclaw logs --follow
# 按级别过滤
openclaw logs --level error
# 导出日志
openclaw logs --export logs.txt配置日志轮转
创建 /etc/logrotate.d/openclaw:
/var/log/openclaw/*.log {
daily
rotate 7
compress
delaycompress
notifempty
create 0640 root root
sharedscripts
postrotate
systemctl reload openclaw
endscript
}监控指标
# 查看状态
openclaw status
# 查看性能指标
openclaw metrics
# 查看资源使用
openclaw stats备份与恢复
备份配置
# 备份配置目录
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw
# 上传到云存储
# 使用阿里云 OSS、腾讯云 COS 等恢复配置
# 解压备份
tar -xzf openclaw-backup-20260304.tar.gz -C ~/
# 重启服务
openclaw restart安全加固
1. 配置防火墙
# 使用 ufw
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable2. 禁用 root 登录
编辑 /etc/ssh/sshd_config:
PermitRootLogin no3. 使用密钥认证
# 生成密钥对
ssh-keygen -t rsa -b 4096
# 上传公钥
ssh-copy-id user@server-ip4. 定期更新
# 更新系统
apt-get update && apt-get upgrade
# 更新 OpenClaw
npm update -g openclaw故障排查
服务无法启动
# 查看日志
journalctl -u openclaw -n 50
# 检查端口占用
netstat -tulpn | grep 18789
# 检查配置
openclaw config validate内存不足
# 增加 swap
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile网络问题
# 测试连接
curl http://localhost:18789
# 检查防火墙
iptables -L -n
# 检查 DNS
nslookup your-domain.com成本估算
腾讯云轻量应用服务器
- 2核2G:约 ¥20-50/月(新用户优惠)
- 2核4G:约 ¥50-100/月
阿里云 ECS
- 2核2G:约 ¥30-60/月
- 2核4G:约 ¥60-120/月
AI 模型费用
- 国内模型:约 ¥0.001-0.015/1K tokens
- 国外模型:约 $0.001-0.015/1K tokens
月度估算:服务器 ¥50 + 模型 ¥50-200 = ¥100-250/月
最佳实践
- 使用云端部署:7×24 小时稳定运行
- 配置 HTTPS:保护数据传输安全
- 启用监控:及时发现和解决问题
- 定期备份:防止数据丢失
- 成本控制:监控 token 使用量
- 安全加固:配置防火墙和访问控制