1.2 KiB
1.2 KiB
title, type, last_updated
| title | type | last_updated |
|---|---|---|
| Layered Configuration | concept | 2026-04-10 |
Definition
Layered Configuration（分层配置）指系统配置存在多个层级，不同层级的配置有不同的优先级和作用范围。修改某一层级的配置无法影响其他层级的行为。
OpenClaw 配置层级
- Global Config (
openclaw.json): 全局 compaction 配置，影响所有 Agent - Agent/Channel Specific Config: 针对特定 Telegram Channel 或 Agent 的模型映射规则
- 环境变量: 启动脚本里的
MODEL_DEFAULT可能覆盖配置文件
Debugging Implication
两层配置要分清：全局 compaction 配置和 agent 模型配置是两码事。改全局不行，就得往 agent 级别去找。
当问题在全局层面无法解决时，需要检查 Agent 级别的路由规则和模型绑定配置。
Related
- Agent-Routing-Rules: Agent 级别配置的具体形式
- Compaction: 全局 compaction 配置的作用范围
- Error-Surface-vs-Root-Cause: 分层配置是"错误表象 ≠ 根本原因"的常见原因