必须部署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
第三步：启动主容器，关键参数不可省略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，系统将自动测试连接；若显示绿色✅，表示接入成功。
