OpenClaw容器需添加--add-host host.docker.internal:host-gateway参数才能连接宿主机模型服务；UI中须选Custom提供商，Base URL填http://host.docker.internal:端口，模型名须与本地服务完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地用 Docker 跑通 OpenClaw 并接入自己部署的大模型，但发现默认启动后 UI 里模型配置项灰掉、无法填写 Base URL 或切换为 Ollama/llama.cpp 等本地后端——这是因为 OpenClaw 容器默认未启用跨容器网络通信，host.docker.internal 解析失败，导致前端无法连接宿主机或同网段的本地模型服务。
确认本地模型服务已就绪
先确保你的模型服务已在宿主机运行且可被 curl 访问：Ollama 运行 deepseek-coder:6.7b 时执行 curl http://localhost:11434/api/tags 应返回 JSON 列表；llama.cpp 启动时需带 -c 4096 -ngl 99 且监听 0.0.0.0:8080，再执行 curl http://localhost:8080 验证响应。若任一失败，OpenClaw 后续配置必报 503 错误。
这一步不能跳过，OpenClaw 容器内无法直连 localhost，它看到的 localhost 是容器自身，不是你的宿主机。
启动 OpenClaw 容器时启用 host.docker.internal
必须在 docker run 命令中显式添加 --add-host host.docker.internal:host-gateway 参数，否则容器内 DNS 无法解析该域名，所有指向 host.docker.internal 的请求都会超时。
完整命令示例（适配 Ollama）：
docker run -it -d --rm --pull=always \-e SANDBOX_RUNTIME_CONTAINER_IMAGE=openhands-runtime:0.0.0.2 \-v /var/run/docker.sock:/var/run/docker.sock \-v ./workspace:/workspace \-v ~/.openhands:/.openhands \-p 3000:3000 \--add-host host.docker.internal:host-gateway \--name openclaw-test \docker.all-hands.dev/all-hands-ai/openclaw:0.28
OpenClaw配置管理最佳实践与常见陷阱。适用场景：(1) 修改配置，(2) 询问路径或结构，(3) 遇到配置错误，(4) 添加渠道，(5) 修改前避免路径错误或直接编辑JSON等常见错误。
注意：【--add-host host.docker.internal:host-gateway 必须存在，缺一则模型配置页无法加载】。Mac 和 Windows Docker Desktop 默认支持该 host，但 Linux 需要 Docker 20.10+ 且 daemon.json 中未禁用 host-gateway 功能。
在 Web UI 中配置本地模型
浏览器打开 http://localhost:3000，首次进入会弹出设置面板。
第一步：选择 LLM 提供商为 “Custom”（不是 OpenAI/Ollama 下拉选项，而是底部的自定义入口）。
第二步：填写模型名称，例如 ollama/deepseek-coder:6.7b 或 llama.cpp/phi-3-mini，名称必须与你本地服务实际注册的模型名完全一致，大小写和冒号都不能错。
第三步：Base URL 填写 http://host.docker.internal:11434（Ollama）或 http://host.docker.internal:8080（llama.cpp）。这里不能填 localhost、127.0.0.1 或宿主机真实 IP——只有 host.docker.internal 在容器网络中才被正确路由到宿主机网卡。
第四步：点击 Save，页面自动刷新，稍等 10～15 秒等待后端重载配置。此时顶部状态栏应显示 “LLM: ollama/deepseek-coder:6.7b (online)”。
