openclaw本地模型不显示的根本原因是ollama服务未正常运行或配置错误。需确认ollama list有模型、api接口可访问，严格校验openclaw.json中provider为"ollama"、base_url为"http://127.0.0.1:11434/v1"、model id与ollama list输出完全一致、agents.defaults.model.primary格式为"ollama/模型名"，并重启gateway后新建session。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置本地模型后界面始终不显示模型名称，新建Session也看不到可用模型选项，说明模型注册流程未真正生效，不是单纯刷新页面能解决的问题。
确认Ollama服务已就绪且模型已加载
打开终端执行 ollama list，检查输出中是否包含你打算使用的模型（如 qwen2.5:3b），若为空则需先拉取：ollama pull qwen2.5:3b。
访问 http://127.0.0.1:11434/api/tags，浏览器应返回JSON数据且包含models数组；如果打不开或报错，说明Ollama服务没运行，需重启Ollama应用或在终端执行 ollama serve 后保持窗口不关闭。
这一步漏掉会导致后续所有配置都无效——OpenClaw根本收不到模型列表。
修正openclaw.json中的关键字段
找到配置文件位置（通常为 ~/.openclaw/openclaw.json 或项目根目录下），用文本编辑器打开。
确保 【provider】 字段值为字符串 "ollama"，不是 "Ollama" 或 ollama（无引号）。
base_url 必须严格写成 "http://127.0.0.1:11434/v1" ——【末尾的 /v1 不可省略，也不可写成 /api 或 /v1/】。写错路径会导致OpenClaw发请求时404，但界面只显示“无模型”，不报具体错误。
model ID 必须与 ollama list 输出的 NAME 列完全一致，包括冒号和版本号，例如 "qwen2.5:3b"。若写成 qwen2.5-3b 或 qwen2.5:3B，模型将无法匹配。
agents.defaults.model.primary 字段必须设为 "ollama/qwen2.5:3b" 格式，开头的 ollama/ 是协议前缀，缺了就不识别。
强制重载配置并新建Session
第一步：停止当前OpenClaw Gateway进程（Ctrl+C 或 kill -9 对应PID）。
第二步：修改完配置后，不要直接重启——先执行 openclaw gateway --config ~/.openclaw/openclaw.json --timeoutSeconds 1800 显式指定超时参数，避免默认60秒导致模型加载中断。
第三步：启动成功后，打开Web界面，【必须点击右上角“New Session”新建会话】，旧Session缓存不会自动更新模型列表。
第四步：在新Session的模型选择下拉框里等待3～5秒，正常应出现带 ollama/ 前缀的模型名。若仍为空，查看浏览器开发者工具Console和Network标签页，筛选 XHR 请求，找 /api/models 接口响应内容是否含 model_id 字段。
