部署方式选择

OpenClaw 支持多种部署方式，可根据实际需求选择：

部署方式	优势	劣势	适用场景
本地部署	运行速度快、数据私有化、无服务器费用	需要备用主机、存在权限风险	有闲置电脑、对数据隐私要求高
Docker 部署	环境隔离、易于迁移、配置简单	需要 Docker 基础知识	开发测试、快速部署
云端部署	7×24 小时运行、配置灵活、无本地设备占用	需支付服务器费用	生产环境、团队协作

入门推荐：优先选择云端部署，成本低、操作简单、稳定性高。

本地部署

环境要求

• Node.js ≥ 22.0.0
• 内存 ≥ 4GB
• 磁盘空间 ≥ 2GB

安装步骤

1. 安装 OpenClaw：

npm install -g openclaw@latest

2. 初始化配置：

openclaw onboard --install-daemon

3. 启动服务：

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. 购买服务器

1. 访问腾讯云轻量应用服务器

2. 选择配置：

   • 地域：国内模型选国内地域，国外模型选海外地域
   • 镜像：选择「OpenClaw 镜像」（如有）或「Ubuntu 22.04」
   • 套餐：2核2G（基础任务）或 2核4G（复杂任务）
   • 时长：按需选择（新用户有优惠）

3. 完成支付，等待服务器初始化（约 1-2 分钟）

2. 连接服务器

方式 1：使用控制台

1. 在服务器列表中点击「登录」
2. 使用浏览器 SSH 终端

方式 2：使用 SSH 客户端

ssh root@your-server-ip

3. 安装 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-daemon

4. 配置防火墙

在腾讯云控制台「防火墙」中添加规则：

• 协议：TCP
• 端口：18789
• 来源：0.0.0.0/0（或限制特定 IP）

5. 启动服务

# 启动 Gateway
openclaw gateway --daemon

# 查看状态
openclaw status

6. 配置域名（可选）

1. 在腾讯云购买域名
2. 添加 A 记录指向服务器 IP
3. 配置 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 实例

1. 访问阿里云 ECS

2. 选择配置：

   • 地域：就近选择
   • 实例规格：ecs.t6-c1m2.large（2核2G）
   • 镜像：Ubuntu 22.04
   • 网络：按需选择带宽

3. 完成购买

2. 配置安全组

在 ECS 控制台「安全组」中添加入方向规则：

• 端口范围：18789/18789
• 授权对象：0.0.0.0/0

3. 安装部署

参考腾讯云的安装步骤。

AWS EC2

1. 创建 EC2 实例

1. 登录 AWS 控制台
2. 选择 EC2 服务
3. 启动实例：
   • AMI：Ubuntu Server 22.04 LTS
   • 实例类型：t3.small（2核2G）
   • 配置安全组：开放 18789 端口

2. 连接实例

ssh -i your-key.pem ubuntu@your-instance-ip

3. 安装部署

参考腾讯云的安装步骤。

使用 OpenClaw 镜像（腾讯云）

腾讯云提供了预配置的 OpenClaw 镜像，可以快速部署。

1. 选择镜像

在购买服务器时，选择「应用镜像」→「OpenClaw」

2. 访问应用管理

服务器启动后：

1. 在控制台点击「应用管理」
2. 进入 OpenClaw 配置界面

3. 配置模型

在「模型」模块：

1. 选择 AI 模型（如阿里千问 Qwen 3.5 Plus）
2. 点击「获取 API KEY」跳转到模型平台
3. 创建并复制 API Key
4. 粘贴到配置框，点击「应用」

4. 配置渠道

在「通道」模块：

1. 选择渠道类型（如飞书）
2. 输入渠道凭证（App ID、App Secret）
3. 点击「添加并应用」

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 enable

2. 禁用 root 登录

编辑 /etc/ssh/sshd_config：

PermitRootLogin no

3. 使用密钥认证

# 生成密钥对
ssh-keygen -t rsa -b 4096

# 上传公钥
ssh-copy-id user@server-ip

4. 定期更新

# 更新系统
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/月

最佳实践

1. 使用云端部署：7×24 小时稳定运行
2. 配置 HTTPS：保护数据传输安全
3. 启用监控：及时发现和解决问题
4. 定期备份：防止数据丢失
5. 成本控制：监控 token 使用量
6. 安全加固：配置防火墙和访问控制

相关资源

• 安装指南
• 快速开始
• 模型配置
• 渠道配置

上一页微信

下一页浏览器工具