OpenClaw Docker 部署指南：搭建私有爬虫管理平台

mkdir F:\shrimp-farm
cd F:\shrimp-farm

这里，F:\shrimp-farm 是示例路径，你可以替换为任何有读写权限的目录。

3. 一键部署 OpenClaw

部署过程简单快捷，只需几个命令就能完成。以下是详细步骤。

步骤 1：编写 docker-compose.yml 在 F:\shrimp-farm 目录下，新建文件 docker-compose.yml，内容如下：

services:
  master-shrimp:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: master-shrimp
    restart: unless-stopped
    ports:
      - "18789:18789" # Web 界面端口
      - "18791:18791" # API 端口
    volumes:
      - ./data:/home/node/.openclaw # 数据持久化目录
    environment:
      - TZ=Asia/Shanghai # 设置时区
      # 如果需要连接本地 Ollama，取消注释并调整 IP
      # - OLLAMA_HOST=http://host.docker.internal:11434

注意：不要添加 network_mode: bridge，否则端口映射可能失效。

步骤 2：启动容器 在项目目录下执行命令：

docker compose up -d

首次启动会自动拉取镜像，等待 1-2 分钟。检查状态：

docker ps

如果输出显示 STATUS 为 healthy，且 PORTS 列有 0.0.0.0:18789->18789/tcp，说明服务已运行。

步骤 3：验证服务

• 浏览器访问：打开 http://127.0.0.1:18789，你应该看到 OpenClaw 登录界面。

命令行测试：

curl http://127.0.0.1:18789 -UseBasicParsing

返回状态码 200 表示正常。

成功标志：Web 界面加载后，输入默认凭据（首次启动生成的 Token）即可登录。

4. 常见问题与排查

部署中可能遇到问题，这里提供快速解决方案。

典型问题速查表：

• 端口冲突：确保 18789 和 18791 未被占用（用 netstat 检查）。
• 容器未启动：运行 docker logs -f master-shrimp 查看错误日志。
• 无法访问 Web 界面：检查 Windows 防火墙是否允许端口。

排查流程图：

无法访问？
↓
┌──────────────┐
│ docker ps    │── PORTS 显示 "-"？──→ 删除 network_mode 并重建
└──────────────┘
↓ 正常
┌──────────────┐
│ curl 测试    │── 连接关闭？───────→ 检查容器日志
└──────────────┘
↓ 正常
┌──────────────┐
│ 浏览器访问   │── 无法加载？───────→ 检查防火墙是否允许端口
└──────────────┘
↓ ✅ 成功访问！

常用诊断命令：

# 查看实时日志
docker logs -f master-shrimp
# 进入容器调试
docker exec -it master-shrimp sh
# 重启服务
docker compose restart
# 完全重建（解决配置问题）
docker compose down
docker compose up -d --force-recreate

5. 注意事项

部署后，注意以下细节以确保稳定运行。

配置注意事项：

• 端口管理：确认 18789 和 18791 空闲，避免冲突。
• 目录权限：./data 目录需有读写权限（Docker 通常自动处理）。
• 防火墙：如果从外部访问，需在 Windows 防火墙添加入站规则。

安全注意事项：

• API Token：容器启动时生成 Token，保存在 ./data 目录，切勿泄露。
• 外网访问：默认只监听本地 IP；如需公网访问，建议使用 Nginx 反向代理并启用 HTTPS。

更新策略：定期拉取最新镜像修复漏洞：

docker compose pull
docker compose up -d --force-recreate

性能注意事项：

• 磁盘空间：定期清理 ./data 中的旧数据，避免堆积。
• 并发控制：根据机器性能，在 OpenClaw 界面调整爬虫并发数。

资源限制：在 docker-compose.yml 添加资源约束（示例）：

services:
  master-shrimp:
    deploy:
      resources:
        limits:
          memory: 2G # 限制内存
          cpus: '2.0' # 限制 CPU

6. 日常使用指南

部署成功后，以下命令和技巧帮你高效管理。

常用操作命令：

# 启动/停止服务
docker compose start
docker compose stop
# 查看日志或资源
docker logs -f master-shrimp
docker stats master-shrimp
# 进入容器
docker exec -it master-shrimp sh

数据管理： 所有数据持久化在 ./data 目录，备份和恢复简单：

# 备份数据
xcopy F:\shrimp-farm\data F:\backup\openclaw-data /E /I /Y
# 恢复数据（先停止容器）
docker compose stop
xcopy F:\backup\openclaw-data F:\shrimp-farm\data /E /I /Y
docker compose start

配置管理： 在容器内使用 openclaw 命令：

# 查看所有配置
openclaw config get all
# 修改配置（如日志级别）
openclaw config set "OPENCLAW_LOG_LEVEL" "debug"
openclaw restart
# 重启生效

日志管理：

# 导出日志到文件
docker logs master-shrimp > openclaw.log 2>&1
# 查看特定时间日志
docker logs --since "2026-03-13T10:00:00" master-shrimp

7. 最佳实践

为了提升性能和稳定性，推荐以下优化配置。

优化 docker-compose.yml 模板：

services:
  master-shrimp:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: master-shrimp
    restart: unless-stopped
    ports:
      - "18789:18789"
      - "18791:18791"
    volumes:
      - ./data:/home/node/.openclaw
      - ./logs:/var/log/openclaw # 额外挂载日志目录
    environment:
      - TZ=Asia/Shanghai
      - OPENCLAW_LOG_LEVEL=info # 控制日志级别
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '2.0'

实践建议：

• 日志分离：挂载 ./logs 目录便于日志分析。
• 定期备份：设置定时任务自动备份 ./data。
• 监控集成：使用 Prometheus 或 Grafana 监控容器资源。
• 测试环境：先在本地测试，再部署到生产服务器。