openclaw接入ollama失败主因是base url和model name填写错误：base url必须为http://localhost:11434（不加/api），model name须严格复制/api/tags中name字段完整值（如qwen2.5-coder:7b），且需先确认ollama list有loaded模型、curl http://localhost:11434/health返回{"status":"ok"}。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw接入Ollama时，模型地址填错会导致启动失败、404错误或直接卡在“connecting to LLM”界面。你不需要手动拼URL，也不能照搬浏览器访问地址，必须严格匹配Ollama的API服务规范和OpenClaw的字段预期格式。
确认Ollama服务是否真正运行
先在终端执行 ollama list，确保至少有一个模型显示为 loaded 状态。如果列表为空或全是 not loaded，说明Ollama服务未启动或模型未拉取成功——此时填任何地址都无效。
再执行 curl http://localhost:11434/health，返回 {"status":"ok"} 才算服务就绪。若提示 connection refused，请先运行 ollama serve 或检查是否被防火墙拦截。
获取正确的Base URL和Model Name
打开浏览器访问 http://localhost:11434/api/tags，页面会显示所有已加载模型的完整信息。找到你要用的模型（如 qwen2.5-coder:7b），注意看它的 name 字段值——这个就是OpenClaw里要填的 Model Name，不是文件名也不是显示名。
Base URL 填 http://localhost:11434，不要加 /api 或 /v1。OpenClaw内部会自动补全路径，如果多加了就会触发 404。这是官方文档没写清楚但实测必踩的坑。
OpenClaw配置界面填写步骤
第一步：打开OpenClaw设置 → LLM Provider → 选择 OpenAI Compatible（不是Ollama专用选项，Ollama走的是OpenAI兼容协议）。
第二步：Base URL 输入 http://localhost:11434；API Key 随意填（如 ollama 或 123），Ollama不校验该字段；Model Name 填上一步从 /api/tags 中复制的完整名称，例如 qwen2.5-coder:7b 或 llama3:8b。
第三步：点击 Test Connection。成功会显示 “Connection OK” 并弹出模型能力检测结果；失败则立刻检查端口是否被占用（sudo lsof -i :11434）、模型名是否带空格、Base URL末尾是否多了斜杠。
这一步操作起来很简单，但90%的连接失败都源于Model Name抄错了——比如把 qwen2.5-coder:7b 写成 qwen25-coder:7b 或漏掉冒号后版本号。
