OpenClaw本地模型地址填错会导致Agent卡在初始化阶段；须先用curl验证Ollama（http://localhost:11434）或vLLM（http://localhost:8000/health）服务是否返回200，再按规范填写Base URL（Ollama用http://host.docker.internal:11434，vLLM用http://host.docker.internal:8000/v1）及模型名，并确保容器添加--add-host host.docker.internal:host-gateway。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地模型地址填写错误会导致Agent无法连接模型服务，直接卡在初始化阶段，连设置界面都进不去。
确认本地模型服务已启动并监听正确端口
先验证Ollama或vLLM服务是否真正运行：执行 curl http://localhost:11434/（Ollama默认）或 curl http://localhost:8000/health（vLLM默认）。返回HTTP 200才算就绪；如果报错Connection refused，说明服务没起来，别急着填地址。
这一步必须做，否则后面所有配置都是白忙活。
OpenClaw中填写本地模型地址的两种方式
方法一：使用Ollama部署的模型
在OpenClaw配置界面 → LLM Settings → Base URL栏填：【http://host.docker.internal:11434】
注意：不是localhost，也不是127.0.0.1——容器内访问宿主机服务必须用host.docker.internal，这是Docker内置解析名。填错会导致“connection refused”且无任何明确报错提示。
模型名称栏填：ollama/your-model-name:latest（例如ollama/qwen2.5-coder:7b）
方法二：使用vLLM/OpenAI兼容API部署的模型
Base URL填：【http://host.docker.internal:8000/v1】
vLLM服务必须启用OpenAI兼容模式（启动时加--enable-auto-tool-choice等参数），否则OpenClaw会因接口不匹配而静默失败。
模型名称栏填实际部署的served-model-name，例如Ornith-1.0-35B，不能写路径或仓库名。
关键验证步骤
① 启动OpenClaw容器时，确保添加网络配置：--add-host host.docker.internal:host-gateway
② 检查容器日志是否有Failed to connect to LLM或HTTP 404 from /v1/models类报错
③ 在OpenClaw UI里点击“Test Connection”，绿色对勾出现才算真正通了
如果测试失败，回到第一步重新检查本地模型服务的端口、路由和API兼容性，不要跳过健康检查。
