一个配置文件在 Linux 上跑得好好的搬到 Windows 上就报Invalid config。报错信息只说Invalid input却不告诉你是哪一行。我花了整整一晚和 OpenClaw 的 schema 校验搏斗。事故现场把 AI 数字员工队伍部署到用户的 Windows 电脑上。一切就绪点下启动 OpenClaw OpenClaw 2026.7.1-2 (0790d9f) [gateway] loading configuration… [gateway] resolving authentication… Gateway failed to start: Invalid config: models.providers.deepseek.models.0: Invalid input agents.list.0: Invalid input agents.list.1: Invalid input第一反应配置文件写错了打开 openclaw.json——格式规整、缩进正确、字段齐全。奇怪的是同一份配置除了路径在 Linux 开发机上跑得好好的——小虾、小牛两个智能体正常工作。同一个配置Linux 能跑Windows 报错。这不是写错了这是我看不懂它要什么。第一层Missing config——配置根本没被读到先解决前置问题。第一次启动时报的是Missing config. Run openclaw setup or set gateway.modelocal配置里明明有mode: local。为什么说 Missing看 openclaw 的源码openclaw.mjsconsthomeDirresolveLauncherHomeDir();return[path.join(homeDir,.openclaw,openclaw.json),path.join(homeDir,.clawdbot,openclaw.json),];resolveLauncherHomeDir()读环境变量OPENCLAW_HOME。我们设了OPENCLAW_HOME E:\ai-team-collab\openclaw于是 openclaw 找的是E:\ai-team-collab\openclaw\.openclaw\openclaw.json注意这个.openclaw子目录——我们的配置放在E:\ai-team-collab\openclaw\openclaw.json没有子目录。配置存在但放错了位置等于没有。修复把配置双写一份到.openclaw子目录。根因一配置文件的位置语义——“存在不等于被读到”。第二层models.0.name: Invalid input——缺字段位置对了下一个错误冒出来models.providers.deepseek.models.0.name: Invalid input错误信息进步了——从整个对象无效变成具体字段无效models.0.name。看我们的配置models:[{id:deepseek-v4-flash,input:[text],output:[text]}]只有id和input/output没有name。openclaw 的 schema 要求模型必须有name。补上{id:deepseek-v4-flash,name:deepseek-v4-flash,input:[text],output:[text]}根因二schema 要求name必填——缺一个字段整个对象无效。第三层models.0: Invalid input——多出来的字段name补上了错误变回了整个对象无效models.providers.deepseek.models.0: Invalid input这次没有具体字段名了——不是缺是多。对比 Linux 上能跑的配置// Linux 能跑{id:mimo-v2.5,input:[text,image],name:mimo-v2.5}// 我们报错的{id:deepseek-v4-flash,name:deepseek-v4-flash,input:[text],output:[text]}差异一目了然Linux 的 models 没有output字段。OpenClaw 的 schema 是严格校验——未知字段 无效。output不是它认识的字段整个对象就被判死刑。去掉outputinput 改成[text, image]{id:deepseek-v4-flash,name:deepseek-v4-flash,input:[text,image]}根因三strict schema——多一个不认识的字段和少一个必填字段结局一样Invalid。第四层agents.list.0: Invalid input——照抄能跑的配置models 修好了轮到 agentsagents.list.0: Invalid input agents.list.1: Invalid input继续对照 Linux 能跑的配置// Linux 能跑{id:main,model:{primary:deepseek/deepseek-v4-flash},heartbeat:{every:12h},identity:{name:小虾}}// 我们报错的{id:main,workspace:E:\\...,model:{primary:deepseek/deepseek-v4-flash,fallbacks:[]},heartbeat:{every:12h},identity:{name:小虾},name:小虾,// ← 多余的imageModel:小米/mimo-v2.5// ← 多余的}三个多余字段name——身份已经在identity.name里了schema 不认 agent 级的nameimageModel——视觉模型配置schema 不认这个位置的字符串fallbacks: []——空数组Linux 的 agent 根本没写 fallbacks逐个删掉agent 只留{id:main,model:{primary:deepseek/deepseek-v4-flash},heartbeat:{every:12h},identity:{name:小虾}}启动——成功。复盘为什么能跑的配置是最好的文档这一晚的排查本质是一次一次对照能跑的配置做 diff报错我们写的能跑的配置修复models.0.name缺 name有 name补 namemodels.0有 output无 output删 outputagents.list.0有 name/imageModel/fallbacks只有 id/model/heartbeat/identity删多余字段错误信息只告诉你Invalid不告诉你Valid 长什么样。而能跑的配置——就在开发机上跑着的那个——就是答案本身。三个教训1. strict schema 是双刃剑。校验严格配置错误能早发现但也意味着多写一个字段 少写一个字段 一样报错。生成配置的代码必须照着官方/已验证的模板拼不能想当然字段越多越保险。2. 平台差异不是玄学是版本差异。Linux 的 openclaw 2026.7.1 接受宽松格式Windows 的 2026.7.1-2 schema 更严格。同一个大版本号小版本之间 schema 可能完全不同。在我机器上能跑不是答案在我这个版本上能跑才是。3. 配置生成器要保守。我们给 save_config 写配置生成逻辑时走了两次弯路——第一次多写了 name 和 imageModel第二次多写了 output 和 fallbacks。生成器宁可少写可选字段也不要写 schema 不认识的字段。少写的字段 openclaw 用默认值多写的字段直接 Invalid。报错信息只告诉你什么是 Invalid能跑的配置才告诉你什么是 Valid。排查配置问题最快的路是找到一份正在运行的配置逐字段 diff。真实事故记录OpenClaw 2026.7.1-2 Windows 部署配置校验排查。从 Missing config 到 Invalid config四层错误四个根因——配置位置、缺字段、多字段、格式版本差异。