“接口错误”说明请求已发出但模型服务未按预期响应，常见于baseurl末尾含斜杠、api协议错配（如ollama-completions与openai-completions混用）、models.id与ollama list输出不一致等硬性配置问题，需逐项核对并重启网关查看实时日志定位具体报错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置本地模型后提示“接口错误”，说明请求已发出但模型服务未按预期响应，常见于URL拼写错误、协议类型错配或模型ID不匹配等硬性配置问题，而非网络连通性故障。
核对配置文件中的baseUrl字段
打开~/.openclaw/openclaw.json，定位到models.providers.*.baseUrl字段。
确认值为http://localhost:端口号（注意：必须是http，不能是https；必须含http://前缀；结尾【不能有斜杠】）。
若模型服务实际运行在192.168.1.100:5000，则baseUrl必须写成http://192.168.1.100:5000，写成http://192.168.1.100:5000/或http://192.168.1.100:5000/v1均会导致404或空响应。
验证api字段是否与后端服务协议一致
方法一：对接ollama（如glm-4-flash、qwen3-9b）→ api字段必须设为ollama-completions。
方法二：对接FastChat、vLLM或OpenAI兼容服务（如部署了Qwen3.5-9B的FastChat）→ api字段必须设为openai-completions。
【二者不可混用】。例如用ollama-completions去调FastChat，会返回405 Method Not Allowed；反之用openai-completions调ollama，会返回404或空body。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
检查模型ID是否与ollama list输出完全一致
第一步：终端执行ollama list，观察第一列内容。
第二步：将输出的第一列字符串（如qwen3-9b、glm-4.7-flash）原样复制，粘贴进配置文件中对应provider的models.id字段。
注意：ollama list显示的qwen3.5-9b ≠ 配置里写qwen3_5_9b；带空格、下划线、点号、大小写的任何差异都会导致Model 'xxx' not found错误。
重启网关并查看实时日志定位具体报错
① 执行openclaw gateway restart，强制加载新配置。
② 立即执行openclaw gateway logs --follow，保持终端窗口开启。
③ 在另一终端触发一次测试请求（如openclaw chat -m qwen3-9b "你好"）。
④ 观察日志中紧随请求之后的ERROR行——它会明确指出是Failed to initialize model provider、Connection refused还是status code 404，据此反推前三步中哪一环出错。
