openhands是获33k+ star的ai编码助手，需同步拉取匹配版本的主镜像和runtime镜像，挂载docker.sock、workspace及.openhands目录，并在web界面启用浏览器和shell工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw不是OpenHands，目前没有名为OpenClaw的主流开源AI开发代理项目；你实际想部署和配置的是OpenHands——一个已获33k+ Star、支持调用外部工具（如终端命令、浏览器、API）的AI编码助手。它的Docker部署本身不额外安装工具，而是通过沙箱容器在运行时动态执行，关键在于启动参数和首次Web配置是否正确启用对应能力。
确认镜像与运行时沙箱匹配
拉取主应用镜像前，必须同步拉取配套的runtime镜像，否则容器启动后无法执行任何外部命令或调用工具：
docker pull docker.all-hands.dev/all-hands-ai/openhands:0.45
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.45-nikolaik
【必须严格匹配版本号】 主镜像（openhands）和runtime镜像（runtime）的版本号不一致会导致沙箱初始化失败，所有外部工具调用均返回“command not found”或超时无响应。
启动容器时挂载必要宿主机资源
执行以下命令启动容器，其中三处挂载缺一不可：
docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.45-nikolaik \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(pwd)/workspace:/workspace \
-v ~/.openhands:/.openhands \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-local \
docker.all-hands.dev/all-hands-ai/openhands:0.45
/var/run/docker.sock挂载是调用Docker内嵌工具的前提；
workspace目录挂载让AI能读写你指定的代码文件；
.openhands目录挂载保存LLM配置、会话历史和工具权限状态。
首次访问Web界面完成工具启用配置
浏览器打开 http://localhost:3000 → 等待页面加载完成（约1–2分钟）→ 点击右上角齿轮图标进入Settings。
第一步：在“LLM Provider”下拉菜单中选择你已准备好的服务商（如OpenAI、Anthropic、DeepSeek等）；
第二步：填入对应API Key和Model名称（例如gpt-4o、deepseek-coder、claude-3-5-sonnet-20240620）；
第三步：向下滚动到“Advanced Settings”区域 → 找到“Enable browser tool”和“Enable shell tool”两个开关 → 全部开启 → 点击Save。
保存后页面自动刷新，此时AI已具备调用curl、git、python、chromium-browser等工具的能力。无需重启容器，新会话即生效。
