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