Docker部署OpenClaw（龙虾）完整指南

一、项目介绍

OpenClaw（龙虾）是一个功能强大的AI助手工具，提供智能对话、知识管理等功能，支持本地部署和多种模型集成。

二、部署步骤

1. 准备工作

• 确保Docker已安装并运行
• 确保Ollama服务已部署（用于提供模型支持）
• 准备本地挂载目录

2. 创建挂载目录

# 创建数据和配置目录
New-Item -ItemType Directory -Path "Z:\Tools\docker\openclaw\data" -Force
New-Item -ItemType Directory -Path "Z:\Tools\docker\openclaw\config" -Force

3. 拉取OpenClaw镜像

从GitHub Container Registry拉取镜像：

docker pull ghcr.io/openclaw/openclaw:latest

4. 启动OpenClaw容器

docker run -d `
--name openclaw `
--restart always `
-p 18789:18789 `
-p 3000:3000 `
-p 5173:5173 `
--add-host=host.docker.internal:host-gateway `
-v "Z:\Tools\docker\openclaw\data:/home/node/.openclaw" `
-v "Z:\Tools\docker\openclaw\config:/app/config" `
-e OPENCLAW_GATEWAY_PASSWORD=123456 `
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 `
-e DEFAULT_MODEL=deepseek-r1:latest `
ghcr.io/openclaw/openclaw:latest

参数说明：

• --restart always：设置容器自动启动
• -p 18789:18789：映射主服务端口
• -p 3000:3000：映射API服务端口
• -p 5173:5173：映射Web界面端口
• -v：挂载本地目录，实现数据持久化
• -e OPENCLAW_GATEWAY_PASSWORD：设置登录密码
• -e OLLAMA_BASE_URL：设置Ollama服务地址
• -e DEFAULT_MODEL：设置默认使用的模型

三、服务验证

1. 检查容器状态

# 查看容器状态
docker ps

# 查看容器日志
docker logs -f openclaw

2. 访问服务

在浏览器中访问：

• 主界面：http://localhost:18789
• Web界面：http://localhost:5173

3. 密码配置

首次访问时，需要在Control UI设置中输入密码：

1. 访问 http://localhost:18789
2. 点击右上角的设置图标
3. 输入密码：123456
4. 保存设置

4. 功能验证

1. 模型验证：发送测试消息，确认使用deepseek-r1模型
2. 数据持久化验证：创建笔记后重启容器，检查数据是否保留
3. 自启验证：重启Docker服务，检查OpenClaw是否自动启动

四、环境变量配置

环境变量	说明	默认值
OPENCLAW_GATEWAY_PASSWORD	登录密码	-
OLLAMA_BASE_URL	Ollama服务地址	http://host.docker.internal:11434
DEFAULT_MODEL	默认模型	deepseek-r1:latest

五、目录结构

Z:\Tools\docker\openclaw\
├── data/           # 数据持久化目录
└── config/         # 配置文件目录

六、常见问题排查

1. 服务无法访问

• 检查容器状态：docker ps
• 检查端口映射：docker port openclaw
• 检查防火墙设置

2. 模型无法使用

• 确保Ollama服务正在运行：docker ps --filter "name=ollama"
• 确保deepseek-r1模型已下载：docker exec -it ollama ollama list
• 检查网络连接：docker exec -it openclaw curl -I http://host.docker.internal:11434

3. 数据丢失

• 检查挂载目录权限
• 确认挂载路径正确
• 检查容器日志：docker logs openclaw

七、最佳实践

1. 定期备份：定期备份挂载的数据目录
2. 版本管理：使用固定版本的镜像，而非latest
3. 资源限制：根据服务器配置限制容器资源使用
4. 安全设置：定期更新密码，限制访问权限
5. 监控服务：设置监控，确保服务正常运行

八、升级与维护

1. 升级OpenClaw

# 停止并删除旧容器
docker stop openclaw
docker rm openclaw

# 拉取最新镜像
docker pull ghcr.io/openclaw/openclaw:latest

# 重新启动容器（使用相同的挂载和环境变量）
docker run -d --name openclaw --restart always ...

2. 维护命令

# 查看容器状态
docker ps

# 查看容器日志
docker logs openclaw

# 进入容器
docker exec -it openclaw bash

# 重启容器
docker restart openclaw

九、总结

通过Docker部署OpenClaw是一种简单、高效的方式，具有以下优势：

• 环境隔离：不影响主机系统
• 部署简单：一键启动，配置灵活
• 数据持久化：通过挂载目录保存数据
• 自启管理：容器自动启动，确保服务可靠性
• 模型集成：与本地Ollama无缝集成

OpenClaw部署完成后，可以作为个人AI助手、知识管理工具使用，为日常工作和学习提供智能支持。