必须部署openhands(非“openclaw”),拉取docker.all-hands.dev/all-hands-ai/openhands:0.28镜像,挂载docker.sock并配置--add-host host.docker.internal:host-gateway,再通过ollama本地加载deepseek-r1模型,于ui中设model name和base url完成接入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Docker环境中部署OpenClaw并接入DeepSeek模型,必须明确一点:当前官方仓库与主流技术文档中不存在名为“OpenClaw”的开源AI开发代理项目。你实际想部署的极大概率是OpenHands(原OpenDevin),其名称常被误听或误写为“OpenClaw”。所有已验证的Docker镜像、配置参数、网络设置及DeepSeek接入路径,均指向docker.all-hands.dev/all-hands-ai/openhands系列镜像。
确认项目身份与镜像来源
执行docker search openhands,观察返回结果中是否包含docker.all-hands.dev/all-hands-ai/openhands;若出现openclaw相关镜像,属非官方第三方构建,不保证兼容性与安全性。
访问 https://github.com/All-Hands-Open-Source/OpenHands 查看最新Release页面,确认当前稳定版标签(如0.28),这是后续拉取镜像的唯一可信依据。
【严禁使用未经签名的第三方镜像】,否则可能导致容器启动失败、API调用中断或模型加载异常。
基础Docker环境准备
确保Docker版本≥24.0.0,运行docker --version验证;若低于该版本,请升级至最新稳定版。
启动Docker守护进程:sudo systemctl start docker(Linux)或打开Docker Desktop(macOS/Windows)。
验证socket挂载权限:执行ls -l /var/run/docker.sock,输出中需含srw-rw----且组为docker;否则后续容器无法调用宿主机Docker引擎。
拉取并运行OpenHands主服务容器
第一步:拉取官方OpenHands服务镜像
执行docker pull docker.all-hands.dev/all-hands-ai/openhands:0.28
第二步:拉取配套沙箱运行时镜像
执行docker pull docker.all-hands.dev/all-hands-ai/runtime:0.28-nikolaik
监控 OpenClaw GitHub 版本更新,获取最新版本发布说明,翻译成中文, 并推送到 Telegram 和 Feishu。用于:(1) 定时检查版本更新 (2) 推送版本更新通知 (3) 生成中文版发布说明
第三步:启动主容器,关键参数不可省略docker run -d \--name openhands-app \-p 3000:3000 \--add-host host.docker.internal:host-gateway \-v /var/run/docker.sock:/var/run/docker.sock \-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.28-nikolaik \docker.all-hands.dev/all-hands-ai/openhands:0.28
这一步必须包含--add-host host.docker.internal:host-gateway,否则容器内无法通过http://host.docker.internal:11434访问宿主机Ollama服务。
本地Ollama部署DeepSeek模型
方法一:直接拉取官方DeepSeek-R1模型
在宿主机终端执行ollama pull deepseek-r1:14b,等待下载完成(约3.5GB)。
方法二:使用Modelfile定制优化参数
创建文件Modelfile,内容为:FROM deepseek-r1:14bPARAMETER num_ctx 1024PARAMETER num_batch 256PARAMETER num_thread 4
然后执行ollama create deepseek-optimized -f Modelfile。
Ollama默认监听http://localhost:11434,无需额外配置即可被OpenHands访问。
OpenHands UI中配置DeepSeek模型
浏览器打开http://localhost:3000,首次访问会引导创建管理员账号。
登录后进入Settings → LLM Settings → Model Provider,选择Ollama。
填写以下两项:
• Model Name:ollama/deepseek-optimized:latest(若用方法二构建)或ollama/deepseek-r1:14b(若用方法一)
• Base URL:http://host.docker.internal:11434
点击Save,系统将自动测试连接;若显示绿色✅,表示接入成功。










