AI创想

标题: OpenClaw 连接本地 vLLM 报 “Connection error“ 问题排查与解决 [打印本页]
作者: 米落枫    时间: 4 天前
标题: OpenClaw 连接本地 vLLM 报 “Connection error“ 问题排查与解决
作者：CSDN博客
适用版本：OpenClaw 2026.2.x
问题现象：修改 vLLM 服务地址后，所有消息均返回 Connection error，gateway 日志持续输出 embedded run agent end: isError=true error=Connection error.
一、问题背景

笔者在将 vLLM 推理服务从旧服务器（10.10.85.220）迁移到新服务器（192.168.1.221）后，修改了 ~/.openclaw/openclaw.json 中的 baseUrl，并重启了 gateway。然而之后无论发送什么消息，均持续报错：
  1. warn  agent/embedded  embedded run agent end: isError=true error=Connection error.
复制代码
二、排查过程

2.1 确认 gateway 状态正常
  1. openclaw gateway status
复制代码
输出显示 gateway 正常运行，RPC probe OK，监听地址正确，排除 gateway 本身问题。
2.2 确认 vLLM 服务可达
  1. curl http://192.168.1.221:8000/v1/models
  2. curl-X POST http://192.168.1.221:8000/v1/chat/completions \-H"Content-Type: application/json"\-d'{"model":"gpt-oss-120b","messages":[{"role":"user","content":"hello"}],"max_tokens":10}'
复制代码
两个接口均正常响应，排除网络问题。
2.3 用 Node.js 直接测试（排除 curl 差异）
  1. node-e"
  2. const http = require('http');
  3. const req = http.request({
  4.   hostname: '192.168.1.221', port: 8000,
  5.   path: '/v1/completions', method: 'POST',
  6.   headers: {'Content-Type': 'application/json'}
  7. }, res => { res.on('data', c => console.log(c.toString())); });
  8. req.write(JSON.stringify({model:'gpt-oss-120b', prompt:'hi', max_tokens:5}));
  9. req.end();
  10. "
复制代码
Node.js 直接调用也成功，排除运行时问题。
2.4 用 strace 抓系统调用
  1. PID=$(pgrep -f"openclaw.*gateway")strace-p$PID-etrace=network -f2>&1|grep-E"connect|192.168"&sleep10;kill %1
复制代码
关键发现：10 秒内完全没有任何到 192.168.1.221:8000 的 TCP connect 调用！所有网络活动都是 mDNS（5353 端口）流量。
这说明 OpenClaw 根本没有发出 HTTP 请求，请求在本地就被拦截了。
2.5 检查 provider 状态与配置覆盖文件
  1. openclaw models status
复制代码
输出中发现：
  1. source=models.json: ~/.openclaw/agents/main/agent/models.json
复制代码
检查该文件：
  1. cat ~/.openclaw/agents/main/agent/models.json
复制代码
发现问题根源：
  1. {"providers":{"vllm":{"baseUrl":"http://10.10.85.220:8000/v1",// ← 旧 IP！...}}}
复制代码
models.json 的优先级高于 openclaw.json，导致所有请求实际发往已下线的旧服务器，反复失败后触发了 OpenClaw 的 cooldown（冷却保护）机制，之后请求在本地直接被拦截，不再发出网络请求。
三、根本原因分析

OpenClaw 存在多层配置文件，优先级从高到低为：
配置文件路径说明
models.json~/.openclaw/agents/main/agent/models.json最高优先级，agent 级别模型配置
auth-profiles.json~/.openclaw/agents/main/agent/auth-profiles.json认证信息
openclaw.json~/.openclaw/openclaw.json全局配置
当用户只修改 openclaw.json 时，models.json 中的旧配置仍然生效，且会覆盖全局配置。
此外，OpenClaw 内置了 Cooldown 冷却保护机制：当某个 provider 连续请求失败多次后，会临时屏蔽对该 provider 的所有请求，表现为请求不发出、直接返回 Connection error。这是一种保护机制，但容易误导排查方向。
四、解决方案

方案一：直接修改 models.json（推荐）
  1. # 将旧 IP 替换为新 IPsed-i's/10.10.85.220/192.168.1.221/g'\
  2.   ~/.openclaw/agents/main/agent/models.json
  4. # 确认修改grep baseUrl ~/.openclaw/agents/main/agent/models.json
  6. # 重启 gateway 清除 cooldown 状态
  7. openclaw gateway restart
复制代码
方案二：同步更新所有配置文件

如果迁移了服务器，建议同时检查并更新所有涉及 IP 的配置：
  1. # 全局搜索旧 IPgrep-r"10.10.85.220" ~/.openclaw/
  3. # 批量替换find ~/.openclaw/ -name"*.json"-exec\sed-i's/10.10.85.220/192.168.1.221/g'{}\;
  5. openclaw gateway restart
复制代码
方案三：重置 cooldown

如果只是想解除冷却状态而不修改配置：
  1. openclaw models status --reset-cooldown
  2. # 或直接重启 gateway
  3. openclaw gateway restart
复制代码
五、验证修复

重启后观察日志，正常情况应看到请求成功：
  1. openclaw logs --follow2>&1|grep-E"agent end|agent start"
复制代码
正常输出示例：
  1. debug  agent/embedded  embedded run agent start: runId=xxx
  2. info   agent/embedded  embedded run agent end: runId=xxx isError=false
复制代码
六、预防建议

七、总结

现象原因解决
Connection error 持续出现cooldown 机制拦截 + models.json 旧 IP修复 models.json + 重启 gateway
strace 无 TCP connect请求未发出，被本地拦截同上
curl/Node.js 直接调用正常底层网络无问题，问题在 OpenClaw 内部同上
修改 openclaw.json 无效被高优先级的 models.json 覆盖修改正确的配置文件




欢迎光临 AI创想 (http://www.llms-ai.com/) Powered by Discuz! X3.4