404错误本质是服务端未注册请求路径，需先用openclaw status确认网关是否运行，再通过curl验证/v1端点、检查baseurl是否含/v1、allowedorigins是否匹配访问源、ssrf防护是否拦截本地请求，并用openclaw doctor诊断修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw部署后访问控制台或调用API返回404，说明请求的路径在服务端完全不可达——不是认证失败、不是超时、而是服务器压根没把这条路注册进路由表，连拦截机会都没有。
先确认是哪一层的404
打开终端，执行：openclaw status。如果显示 Gateway: stopped 或 RPC probe: failed，说明网关根本没跑起来，后续所有请求都会被系统级拒绝，直接返回404。这和配置无关，是服务未启动导致的假404。
若状态正常，再运行：curl -v http://localhost:18789/v1/models。观察响应头里的HTTP/1.1 404是否来自OpenClaw自身（比如返回{"error":"Not Found"}），还是来自反向代理（如Nginx返回空白页+404）。前者是OpenClaw内部路由问题，后者是前置网关转发错路。
检查 baseUrl 是否带 /v1 后缀
OpenClaw对接大模型时，【baseURL必须精确包含/v1路径段】，少一个斜杠或多个斜杠都会触发404。例如：
✅ 正确写法："baseURL": "https://apitoken.fun/v1"
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
❌ 错误写法："baseURL": "https://apitoken.fun"（缺/v1）或 "baseURL": "https://apitoken.fun//v1"（多斜杠）
本地Ollama用户尤其容易踩坑：Ollama本身提供/api/tags和/v1/models两套接口，但OpenClaw只认/v1前缀的OpenAI兼容路径。务必用curl http://localhost:11434/v1/models验证Ollama是否真支持该端点，不支持就升级Ollama到0.1.16+版本。
验证 gateway.controlUi.allowedOrigins 配置
方法一：运行命令查看当前设置openclaw config get gateway.controlUi.allowedOrigins
如果返回空数组[]或只含["http://localhost"]，而你实际用http://192.168.254.196:18789访问，浏览器会因CORS被拦截，部分前端框架可能静默转成404。
方法二：临时放行全部来源（仅调试用）openclaw config set gateway.controlUi.allowedOrigins '["*"]' --json
【注意：生产环境严禁使用 "*"】，改完必须重启网关：openclaw gateway restart。
排查 SSRF 安全策略拦截
第一步：确认OpenClaw版本是否为2026.4.2或更新openclaw --version 输出含2026.4.2即启用新SSRF防护。
第二步：检查是否正尝试调用http://localhost或http://127.0.0.1类地址
新版默认禁止所有私有网络HTTP请求，哪怕服务就在本机。此时ollama_web_fetch工具会直接返回404，不发任何网络包。
第三步：临时关闭防护（仅限开发环境）
编辑~/.openclaw/openclaw.json，在gateway节点下添加："ssrfProtection": false
保存后执行openclaw gateway restart。
用 openclaw doctor 一键扫描
① 运行诊断命令：openclaw doctor
② 若输出含blocking issue: missing baseURL in llm provider，说明配置文件里llm.provider块缺失baseURL字段；
③ 若提示gateway.port conflict with process PID 12345，说明18789端口被占用，需杀进程或改端口；
④ 出现config schema validation failed时，打开~/.openclaw/openclaw.json，删除所有注释行（JSON标准不支持//注释），再重试。
诊断通过后，直接运行：openclaw doctor --fix自动修正可修复项。
