我接触OpenClaw（社区里都叫它"龙虾"）有段时间了，从一开始在自己笔记本上装着玩，到后来在公司搭了一套给团队用，再到现在帮几个朋友做了小集群部署，算是对它的部署模式有了比较完整的认知。这篇就把从单机到集群的完整过程梳理一下，不同阶段适合什么部署方式、各有什么优缺点，给正在考虑部署方案的朋友一个参考。

OpenClaw最新版本一键部署包下载地址：TopClaw官网一键免费部署OpenClaw

部署OpenClaw，首先要搞清楚你的使用场景。一个人自己用，和给整个团队用，和对外提供商业服务，这三者的需求差异非常大。用错部署方式不是说不能用，而是要么浪费资源、要么性能不够、要么不好维护。先根据场景选对方案，再动手安装，能省掉很多后续折腾。

个人单机部署是最简单的场景。你一个人用，一台电脑或者一台云服务器，装一个OpenClaw实例就行。这种模式适合个人开发者、技术爱好者，或者想先体验一下再决定要不要深入的人。安装过程我在之前的文章里详细介绍过，核心就是解压安装包、运行安装脚本、配置API Key、启动服务，总共不到十分钟。

# 单机部署——最简安装流程（适用于Windows/macOS/Linux）

# 第1步：下载并解压
mkdir -p ~/openclaw && cd ~/openclaw
tar -xzf openclaw-linux-amd64.tar.gz

# 第2步：安装
./install.sh

# 第3步：配置（编辑 conf/config.yaml）
cat <<'EOF' > conf/config.yaml
models:
  default: gpt-4o
  providers:
    openai:
      api_key: sk-your-key

server:
  host: 127.0.0.1
  port: 8080

gateway:
  enabled: true
  max_concurrent: 3
EOF

# 第4步：启动
openclaw gateway start

# 第5步：验证
openclaw agent create --name hello --model gpt-4o \
  --prompt "你是助手"
openclaw chat --agent hello "测试连接"

单机模式下，Gateway的max_concurrent参数建议设小一点，3到5就够了。这个参数控制同时能处理的请求数，单机用的话设太大了反而可能把系统资源吃光。如果后续觉得不够用，随时可以改配置重启。

团队共享部署是第二步。当你发现身边的同事也想用，你不想每个人都装一套，也不想共享同一个Agent的对话记录，这时候就需要考虑多用户隔离了。OpenClaw支持多用户模式，每个用户有独立的Agent、独立的对话历史、独立的技能配置，但共享同一个Gateway服务。

# 团队部署——多用户配置

# conf/config.yaml 添加用户管理
server:
  host: 0.0.0.0
  port: 8080

auth:
  enabled: true
  provider: local
  users:
    - username: zhangsan
      password: "${ZS_PASSWORD}"    # 建议用环境变量，不要明文写
      role: admin
    - username: lisi
      password: "${LS_PASSWORD}"
      role: user

# Agent隔离配置
agent:
  namespace: true    # 开启命名空间隔离
  default_namespace: "personal"

# 资源限制（防止某个用户占满资源）
resource:
  per_user:
    max_agents: 10
    max_cron_jobs: 20
    max_daily_requests: 500

多用户模式的核心配置是开启命名空间隔离和设置资源配额。命名空间隔离确保每个用户只能看到和操作自己的Agent，不会互相干扰。资源配额则防止某个用户创建太多Agent或者发起太多请求，影响其他人的使用体验。

团队部署通常放在一台配置好一点的云服务器上，4核8G内存就能支撑10到20个人的日常使用。如果预算充足，建议用两台服务器做主备，这样一台挂了另一台能接管。不过对于小团队来说，单台服务器配合定期备份基本就够用了。

# 服务器推荐配置

# 小团队（5-15人）
CPU: 4核
内存: 8GB
硬盘: 50GB SSD
带宽: 5Mbps
系统: Ubuntu 22.04 LTS
预估月费: ¥100-200

# 中型团队（15-50人）
CPU: 8核
内存: 16GB
硬盘: 100GB SSD
带宽: 10Mbps
系统: Ubuntu 22.04 LTS
预估月费: ¥300-500

# 自动备份脚本（每天凌晨3点执行）
#!/bin/bash
# backup.sh
BACKUP_DIR="/data/backups"
DATE=$(date +%Y%m%d)
tar -czf "$BACKUP_DIR/openclaw_$DATE.tar.gz" \
  /opt/openclaw/conf/ \
  /opt/openclaw/data/
# 保留最近30天的备份
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete
echo "备份完成: openclaw_$DATE.tar.gz"

集群化部署是第三步，适合需要对外提供服务或者内部用户规模较大的场景。OpenClaw的集群方案核心思路是：前端用Nginx做负载均衡，后端跑多个Gateway实例，共享同一个数据存储。这样任何一个Gateway挂了，请求会自动路由到其他实例，服务不中断。

# 集群部署架构示意

#                    ┌─────────────┐
#      用户请求 ──→ │   Nginx LB  │
#                    └──────┬──────┘
#                           │
#              ┌────────────┼────────────┐
#              ▼            ▼            ▼
#        ┌──────────┐ ┌──────────┐ ┌──────────┐
#        │Gateway-1 │ │Gateway-2 │ │Gateway-3 │
#        └────┬─────┘ └────┬─────┘ └────┬─────┘
#             │            │            │
#             └────────────┼────────────┘
#                          ▼
#                    ┌───────────┐
#                    │  共享存储  │
#                    │ (数据库/  │
#                    │  文件系统) │
#                    └───────────┘

Nginx负载均衡的配置也不复杂。关键是要做好会话保持（sticky session），因为OpenClaw的对话是有状态的，同一个用户的连续请求需要路由到同一个Gateway实例，否则对话上下文会丢失。

# nginx.conf - OpenClaw集群负载均衡配置

upstream openclaw_cluster {
    # ip_hash 实现会话保持
    ip_hash;
    
    server 192.168.1.101:8080 weight=1;
    server 192.168.1.102:8080 weight=1;
    server 192.168.1.103:8080 weight=1;
    
    # 健康检查
    # 当某个节点连续3次失败后暂时移除
}

server {
    listen 80;
    server_name openclaw.yourdomain.com;
    
    # HTTPS配置（生产环境强烈建议）
    # listen 443 ssl;
    # ssl_certificate /path/to/cert.pem;
    # ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://openclaw_cluster;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_connect_timeout 60s;
        proxy_read_timeout 120s;
    }
}

集群部署中还有一个重要的点：数据存储要独立于Gateway实例。默认情况下OpenClaw把数据存在本地文件系统里，这在单机模式下没问题，但在集群模式下会导致数据不一致。解决方案是用外置数据库（推荐PostgreSQL）和共享文件系统（NFS或者对象存储）。

# Gateway配置——连接外部数据库
# conf/config.yaml

database:
  type: postgresql
  host: 192.168.1.200
  port: 5432
  name: openclaw
  user: openclaw_user
  password: "${DB_PASSWORD}"

storage:
  type: s3
  endpoint: https://your-s3-endpoint.com
  bucket: openclaw-data
  access_key: "${S3_ACCESS_KEY}"
  secret_key: "${S3_SECRET_KEY}"

从单机到集群的演进路径大致就是这样。我的建议是：先跑通单机，确认功能和性能满足需求，再考虑团队共享，最后才上集群。不要一上来就搞集群，运维复杂度和成本会指数级上升，而你的实际需求可能根本用不上。技术选型最忌讳过度工程化，适合当前阶段的方案才是最好的方案。

补充一个运维方面的建议：不管哪种部署方式，一定要做好日志收集和监控。OpenClaw的日志默认输出到控制台和文件，建议用日志收集工具（如Filebeat+ELK）做集中管理。监控方面，可以用Prometheus抓取Gateway暴露的metrics接口，配合Grafana做可视化。这些工作前期花几个小时搭好，后面能省掉大量排查问题的时间。