401错误主因是Base URL配置错误，需严格匹配服务商文档中的/v1根路径；其次检查API Key有效性、模型ID是否真实注册、代理与CORS限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置API Key后页面显示“正在连接”但始终无法开始对话，说明服务端已启动但认证或路由环节中断，必须逐层验证基础链路是否通达。
确认 Base URL 是否指向正确接口层级
打开 OpenClaw 配置界面，检查 Base URL 字段是否填写为 https://your-api-domain.com/v1 ——不是控制台首页，也不是 /v1/chat/completions 全路径，更不能漏掉 /v1 后缀。如果填成 https://your-api-domain.com 或 https://your-api-domain.com/v1/，服务会返回 404 或重定向失败。
这一步错一个字符就全盘失效，【Base URL 必须严格匹配服务商文档中明确标注的 API 根路径】。
用 curl 直接验证最小请求通路
在终端执行以下命令（替换 YOUR_API_KEY 和 YOUR_MODEL_ID）：
curl -X POST https://your-api-domain.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"hello"}]}'
如果返回 401，说明 Key 无效或不属于该域名入口；返回 404，说明 Base URL 层级错误；返回 model_not_found，说明模型 ID 不是服务端真实注册的 ID（注意：不是网页上显示的“Qwen2.5-7B”这类别名，而是后台实际启用的 ID，如 qwen25-7b-instruct）。
这一步操作起来很简单，直接把命令复制粘贴进终端回车就行。
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
检查 OpenClaw 客户端是否加载了正确的模型列表
方法一：等待页面自动拉取模型列表（通常需 5～10 秒），若超过 15 秒仍为空，刷新页面并观察控制台 Network 标签页中 /v1/models 请求是否返回 200 及有效 JSON 数组。
方法二：手动在配置中填入已知可用的模型 ID（如 llama3-70b、deepseek-r1 等），跳过自动发现流程。很多第三方兼容接口不实现 /v1/models 端点，OpenClaw 默认行为会卡住。
注意：部分服务商会对 /v1/models 接口做鉴权隔离，即使 /v1/chat/completions 能通，这个端点也可能被禁用。
排查代理与跨域限制
第一步：关闭所有浏览器插件，尤其是广告拦截、隐私保护类扩展，它们可能屏蔽 WebSocket 连接或篡改 Authorization 头。
第二步：在浏览器开发者工具 Console 中输入 localStorage.getItem('openclaw_api_config')，确认存储的配置对象中 key、url、model 三项均为字符串类型且无前后空格。
第三步：若部署在本地开发环境（如 http://localhost:5173），而 API 服务启用了严格的 CORS 策略，需在服务端显式允许 origin，否则 fetch 请求会在预检阶段被拦截，OpenClaw 页面无任何报错提示，仅表现为静默失败。
