OpenClaw Docker 部署指南
1. OpenClaw 简介
OpenClaw 是一个开源的网络爬虫管理服务平台，提供直观的 Web 界面和强大的 API 接口。核心功能包括：
- 可视化任务调度：轻松创建、监控和停止爬虫任务。
- 数据管理：统一存储和导出采集的数据。
- AI 集成：无缝对接 Ollama、OpenAI 等服务，实现智能内容分析（如摘要、分类）。
- API 支持：通过 RESTful API 与其他系统集成。
适用场景：
- 批量抓取网页数据用于分析或训练模型。
- 配合大语言模型进行内容提取或自动化处理。
- 搭建私有的数据采集基础设施，避免依赖第三方服务。
- 学习和研究爬虫技术，提升开发技能。
技术架构： 部署后，OpenClaw 运行在 Docker 容器中，通过端口映射对外提供服务：
┌─────────────────────────────────────────────────┐
│ Windows 主机 │
│ ┌─────────────────────────────────────────────┐ │
│ │ Docker Desktop │ │
│ │ ┌─────────────────────────────────────────┐ │ │
│ │ │ master-shrimp 容器 │ │ │
│ │ │ ┌───────────────────────────────────┐ │ │ │
│ │ │ │ OpenClaw 服务 │ │ │ │
│ │ │ │ 端口：18789 (Web) │ │ │ │
│ │ │ │ 端口：18791 (API) │ │ │ │
│ │ │ └───────────────────────────────────┘ │ │ │
│ │ └─────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
↓ 端口映射
http://127.0.0.1:18789
Web 界面通过 http://127.0.0.1:18789 访问，API 则通过端口 18791 调用。
2. 部署前准备
在开始部署前，确保你的环境满足以下要求，并进行基础检查。
系统要求：
- 操作系统：Windows 10 或 11（64 位）。
- Docker：Docker Desktop 4.0+，并启用 WSL2 后端。
- 资源：至少 4GB RAM 和 10GB 磁盘空间。
- 网络：稳定的互联网连接，用于拉取镜像。
环境检查： 打开 PowerShell（建议以管理员身份运行），执行以下命令确认环境正常：
# 检查 Docker 是否安装并运行
docker --version
# 如果输出类似 'Docker version 24.0.7'，说明已安装
# 查看 WSL2 状态
wsl --list --verbose
# 确保状态为 'Running'
# 检查端口 18789 和 18791 是否空闲
netstat -ano | findstr "18789 18791"
# 无输出表示端口可用，否则需要关闭占用程序
创建项目目录： 选择一个位置存放 OpenClaw 的数据和配置，例如：
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 监控容器资源。
- 测试环境：先在本地测试，再部署到生产服务器。
