第四章 配置体系与模型治理

在第二章中，openclaw onboard 向导已经帮你完成了模型与认证的最小接入——内置供应商的密钥已写入 auth-profiles，默认模型已可用。但“能用”和“能放心地长期用”之间还隔着几步。

本章的目标不是重复“接入”，而是把接入治理化：这意味着：

• 配置可解释：三个月后，你能清楚地说出“为什么当前用的是这个模型”，而不是“我也忘了怎么配的”

• 认证可轮换：API Key 泄露了，或者企业要求定期轮换，你能在 10 分钟内无缝切换到备用 Key，不中断服务

• 选型有依据：需要在 Claude、当前 OpenAI 旗舰模型、本地模型之间选择，你有一个四维框架（成本、质量、延迟、可靠性）来评估

• 故障可回退：主模型或主 provider 出现故障时，系统能按显式 fallback 链切换到可用备选，而不是整个服务瘫痪

读完本章后，你应能独立回答三个问题：当前配置从哪里生效、当前模型为什么被选中、当前失败时系统会如何退化。

本章内容导读

本章包括以下几个小节：

• 4.1 openclaw.json 结构与配置优先级：理解 openclaw.json 的核心结构与配置优先级。

• 4.2 模型供应商接入与认证方式：区分内置供应商默认路径与自定义供应商显式配置路径，掌握密钥注入与轮换机制。

• 4.3 模型选择与默认策略：建立模型选择的质量/成本/延迟/可靠性四维决策框架。

• 4.4 故障转移基础：回退链路与恢复策略：配置并验证基础故障转移链路。

• 4.5 本章小结：关键结论与自测题。

学习目标

完成本章的阅读后，你将能够：

1. 理解配置：快速定位配置的优先级与生效规则。

2. 治理认证：区分内置供应商的默认路径与自定义供应商的显式配置路径，掌握密钥注入与安全轮换。

3. 做出决策：基于质量、成本、延迟与可靠性做出合理的模型选择。

4. 规划容错：设计基本的故障转移链路，提高系统稳定性。