OpenClaw接入Ollama后模型不显示，需逐层排查：确认Ollama服务运行（ollama serve）、端口11434未被占用、API端点http://localhost:11434/api/tags可访问并返回非空JSON、config.yaml中base_url正确且无硬编码model、清除缓存并强制刷新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw接入Ollama后模型不显示，说明配置链在某个环节断开——可能是Ollama服务未真正启动、模型未正确加载、API地址格式错误，或是OpenClaw读取模型列表时被HTTP状态码拦截。这一步卡住后，后续所有AI指令都无法触发，必须逐层验证。
确认Ollama服务是否真实运行
打开终端，执行 ollama list。如果返回空列表或报错 command not found，说明Ollama根本没装好或没加入PATH。
若命令能运行但输出为空，执行 ollama ps 查看是否有模型正在运行。没有输出即代表服务进程未启动，此时直接运行 ollama serve 启动后台服务——注意不要加 & 或后台符号，先让它前台运行，方便观察日志。
【关键前提】Ollama必须处于监听状态，且默认端口11434未被其他程序占用。可用 lsof -i :11434（macOS/Linux）或 netstat -ano | findstr :11434（Windows）检查端口占用情况。若被占用，要么杀掉对应PID，要么在Ollama配置中改端口——但OpenClaw默认只认11434，改端口就得同步改OpenClaw的config.yaml。
验证Ollama模型API能否被正常访问
在浏览器中打开 http://localhost:11434/api/tags（不是/v1/models）。这是Ollama官方API端点，返回JSON格式的模型列表。如果页面空白、超时或显示404，说明服务没起来，或防火墙/代理拦截了本地请求。
若返回JSON但models数组为空，说明你下载的模型没成功载入。此时回到终端，执行 ollama pull llama3:8b（或其他你打算用的模型名），等待拉取完成后再刷新API页面。
注意：Ollama 0.3.0+版本已弃用/v1/models路径，OpenClaw若仍硬编码该路径就会收不到数据。请检查你的OpenClaw版本——2026年6月后的最新版已适配/api/tags，旧版需手动修改openclaw/llm/ollama.py中的URL前缀。
检查OpenClaw配置文件中的模型源设置
打开OpenClaw项目根目录下的config.yaml，定位到llm:区块。
将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码，无需手动配置。支持 Mac、Linux 和 VPS。
方法一：确认provider字段值为ollama，且base_url严格写成http://localhost:11434（结尾不能带/api或/v1）。
方法二：若使用自定义端口（如11435），则base_url必须同步更新，且Ollama启动时要加参数：OLLAMA_HOST=0.0.0.0:11435 ollama serve。
方法三：有些用户把model字段直接填成llama3:8b，这是错误的——OpenClaw启动时会先调/api/tags获取列表，再匹配名称。如果填了不存在的模型名，它不会报错，而是静默跳过，导致界面空荡荡。删掉model:这一行，让OpenClaw自动枚举。
改完保存，重启OpenClaw进程。此时终端应打印类似Loaded 3 models from Ollama: llama3:8b, deepseek-coder:6.7b, qwen2.5-coder:7b的日志。没有这行输出，就说明配置仍未生效。
强制刷新OpenClaw模型缓存
第一步：进入OpenClaw安装目录，执行 rm -rf .cache/ollama_models.json（Linux/macOS）或 del .cache\ollama_models.json（Windows）。
第二步：确保Ollama服务正在运行，且http://localhost:11434/api/tags可访问。
第三步：启动OpenClaw时追加环境变量强制重载：OPENCLAW_FORCE_REFRESH=1 python main.py。
这一步会绕过内存缓存，重新发起HTTP请求并解析响应体。如果API返回正常但OpenClaw仍不显示，说明JSON结构解析失败——常见于Ollama版本与OpenClaw解析器不兼容。此时需查看.cache/ollama_models.json内容，对比http://localhost:11434/api/tags原始响应，确认models字段是否存在、是否为数组、每个元素是否含name键。
