OpenClaw新手遇“Provider不存在”报错，根本原因是未显式声明并验证免费LLM服务提供方（如ollama、lmstudio、llamacpp）的拼写、模块存在性、本地服务运行状态及配置完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw新手在配置免费API时频繁遇到“Provider不存在”报错，根本原因是启动时未正确加载或识别所选的免费LLM服务提供方，比如Ollama、LMStudio或本地运行的Llama.cpp服务——这些 provider 不是 OpenClaw 内置默认启用项，必须显式声明并确保服务已就绪。
确认 Provider 名称拼写与注册状态
打开 config.yaml 或 openhands.toml（取决于你用的版本），找到 llm 配置块下的 provider 字段；【必须严格匹配官方支持列表中的小写字符串】，例如 ollama、lmstudio、llamacpp，不能写成 Ollama、ollama-server 或 local-ollama。
检查项目根目录下 openhands/llm/providers/ 是否存在对应名称的 Python 模块文件夹（如 ollama/），缺失则说明该 provider 未被代码注册，强行配置会直接触发 ProviderNotFound 异常。
验证本地服务进程是否真正运行并可连通
方法一：用 curl 直接探测服务健康端点
对 Ollama 执行：curl http://localhost:11434/health；返回 {"status":"ok"} 才算就绪。若报 Connection refused，说明 Ollama 进程根本没启动，或监听地址不是 localhost:11434。
方法二：检查 LMStudio 是否开启 API 模式
LMStudio 默认不开放 HTTP API；必须手动点击右上角「≡」→「Settings」→ 勾选「Enable Local Server」→ 设置端口（默认 1234）→ 点击「Start Server」；【未点「Start Server」按钮，配置再对也白搭】。
强制指定模型路径与基础参数
第一步：确认模型已在本地加载
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
Ollama 用户执行 ollama list，输出中必须包含你 config 中写的 model 名（如 phi3:mini）；若为空或不匹配，先运行 ollama pull phi3:mini。
第二步：在配置中显式补全必要字段
仅设 provider: ollama 不够，还必须指定：
model: phi3:mini
base_url: http://localhost:11434
第三步：删掉所有冗余字段
删除 api_key、organization_id、api_version 等专用于 OpenAI/Azure 的字段——它们会干扰 provider 初始化逻辑，导致底层尝试按 OpenAI 协议连接本地服务而失败。
