openclaw多模型配置后接口报错主因是模型服务未真正启动、配置文件语法错误、环境变量未注入或docker网络不通；需依次验证进程监听、健康端点、yaml缩进与name唯一性、env变量生效情况，以及cors和容器间连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw多模型配置后接口报错，常见于模型服务地址冲突、环境变量未生效或模型权重路径错误，直接导致HTTP 500或Connection refused返回。
确认模型服务是否真正启动
进入每个模型对应的服务目录，执行ps aux | grep python或lsof -i :端口号，查实进程是否在运行。若只看到启动命令但无监听进程，说明模型服务根本没起来。
检查各模型服务日志，重点看是否有OSError: [Errno 2] No such file or directory类报错——这往往意味着model_path指向了不存在的路径，或者路径含中文/空格未做转义。
用curl -v http://localhost:8001/health逐个探测模型健康端点。只要一个不通，OpenClaw主服务就会在路由时抛出500错误，而不是跳过该模型。
验证OpenClaw配置文件语法与加载顺序
打开config.yaml，确认models:下每个模型块都严格缩进，且name字段值不重复——重复名称会导致YAML解析失败，但OpenClaw默认不报错，只静默丢弃后续同名项。
方法一：用python -c "import yaml; print(yaml.safe_load(open('config.yaml')))"手动解析配置。如果报ScannerError，说明缩进或冒号后空格不合规；如果输出中缺少某个模型，大概率是name重复或层级错位。
方法二：临时删掉除一个模型外的所有配置，确认单模型能跑通。再逐个加回，定位到第几个模型加入后开始报错——这能快速锁定是配置本身问题还是模型服务问题。
PC控制工具，远程操控Windows主机，实现截屏、键鼠、文件、进程、浏览器自动化及Shell命令等操作。触发词：控制电脑、操作PC、截图、键盘、鼠标、文件管理、浏览器。
检查环境变量注入是否生效
OpenClaw启动时依赖MODEL_A_URL、MODEL_B_TIMEOUT等环境变量覆盖配置文件值。若你在.env里写了MODEL_A_URL=http://127.0.0.1:8001，但启动命令没加--env-file .env，这些变量根本不会被读取。
进入容器或进程内，执行env | grep MODEL。如果输出为空，说明环境变量没注入成功——此时OpenClaw会 fallback 到配置文件里的默认地址，而那个地址很可能并不存在或已变更。
【关键前提】所有模型服务必须启用CORS，否则浏览器前端调用OpenClaw代理时会因跨域被拦截，表现为接口返回空或预检请求（OPTIONS）失败。在模型服务启动参数中显式添加--cors-allow-origin="*"或对应前端域名。
排查Docker网络连通性
第一步：进入OpenClaw容器内部，执行ping model_a（假设你在docker-compose.yml里定义了service别名为model_a）。若无法解析域名，说明Docker网络DNS没生效，需检查docker-compose.yml中services是否在同一network下，且没有用network_mode: host破坏隔离。
第二步：若域名可解析，再执行nc -zv model_a 8001。连接超时说明目标容器未暴露端口，或ports:只映射了宿主机端口而没在容器内监听；连接拒绝说明服务进程未启动或监听了127.0.0.1而非0.0.0.0。
第三步：确认模型容器的EXPOSE指令与实际监听地址一致。例如FastAPI服务若写uvicorn app:app --host 127.0.0.1 --port 8001，则仅本机可访问；必须改为--host 0.0.0.0才能被同网络其他容器访问。
