OpenClaw 上下文超限问题修复 ...reserveTokensFloor to 20000 or higher.

问题现场

在使用 OpenClaw 进行长对话时，突然遇到以下报错：

Context limit exceeded. I've reset our conversation to start fresh...
To prevent this, increase your compaction buffer by setting 
agents.defaults.compaction.reserveTokensFloor to 20000 or higher.

表面看是上下文超限，实际是配置逻辑错误导致的连锁反应。

🔍 问题根因分析

核心矛盾：配置不匹配

OpenClaw 的上下文压缩机制需要两个参数协同工作：

错误链条

错误的 contextWindow (16000)
    ↓
reserveTokensFloor (20000) > contextWindow (16000)
    ↓
压缩功能无法触发（预留空间超过总容量）
    ↓
对话内容无限累积
    ↓
触发硬性上限 → 会话重置

关键发现：当 reserveTokensFloor ≥ contextWindow 时，压缩机制会失效，因为系统无法在预留缓冲的同时容纳任何对话内容。

🛠️ 修复步骤

步骤 1：定位配置文件

打开 OpenClaw 配置文件：

~/.openclaw/openclaw.json

步骤 2：修正模型上下文配置

在 models.providers[].models[] 数组中，找到所有自定义模型，将 contextWindow 从默认值改为实际值：

{
  "models": {
    "providers": {
      "custom-integrate-api-nvidia-com": {
        "models": [
          {
            "id": "google/gemma-4-31b-it",
            "contextWindow": 128000,  // ✅ 修正：16000 → 128000
            "maxTokens": 4096
          },
          {
            "id": "openai/gpt-oss-20b",
            "contextWindow": 128000,  // ✅ 修正：16000 → 128000
            "maxTokens": 4096
          },
          {
            "id": "stepfun-ai/step-3.5-flash",
            "contextWindow": 128000,  // ✅ 修正：16000 → 128000
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

步骤 3：调整压缩缓冲配置

在 agents.defaults.compaction 中，增加 reserveTokensFloor：

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard",
        "timeoutSeconds": 900,
        "reserveTokensFloor": 40000  // ✅ 修正：20000 → 40000
      }
    }
  }
}

步骤 4：验证配置关系

确保满足以下不等式：

reserveTokensFloor (40000) < contextWindow (128000)

✅ 40000 < 128000，压缩功能可正常触发

步骤 5：重启生效

# 重启 OpenClaw Gateway
openclaw gateway restart

📊 修复效果对比

💡 经验总结

配置原则

1. contextWindow 必须填写真实值
   • 不要使用默认值 16000
   • 查阅模型官方文档确认实际支持的上下文长度
   • 主流大模型（Gemma 4、Step 系列、GPT-OSS）通常支持 128000
2. reserveTokensFloor 必须小于 contextWindow
   • 建议值：20000~40000
   • 太小：压缩频繁，影响性能
   • 太大：压缩无法触发，导致超限
3. 更换模型时同步更新
   • 不同模型的上下文长度可能不同
   • 及时更新配置文件中的对应参数

排查思路

遇到类似问题时，按以下顺序检查：

1. 查看报错信息中的参数建议
2. 检查 contextWindow 是否为模型真实值
3. 验证 reserveTokensFloor < contextWindow
4. 确认压缩模式是否为 "safeguard"
5. 重启服务使配置生效

🎯 配置模板（NVIDIA API 用户）

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard",
        "timeoutSeconds": 900,
        "reserveTokensFloor": 40000
      },
      "model": {
        "primary": "custom-integrate-api-nvidia-com/stepfun-ai/step-3.5-flash"
      }
    }
  },
  "models": {
    "providers": {
      "custom-integrate-api-nvidia-com": {
        "baseUrl": "https://integrate.api.nvidia.com/v1",
        "models": [
          {
            "id": "google/gemma-4-31b-it",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

📌 总结

问题本质：配置参数之间的逻辑关系不满足系统要求

解决方法：修正 contextWindow 为真实值，确保 reserveTokensFloor < contextWindow

影响范围：所有使用自定义模型的 OpenClaw 用户

修复成本：5 分钟修改配置 + 重启

这个问题的隐蔽性在于：配置文件中没有语法错误，系统也能正常运行，但关键功能（上下文压缩）实际上处于失效状态。只有当对话长度超过阈值时，问题才会暴露。

建议：立即检查你的 openclaw.json 配置，确保这两个参数匹配！

openclaw问题 openclaw

版权所有 © 【代码谷】 欢迎非商用转载，转载请按下面格式注明出处，商业转载请联系授权，违者必究。（提示：点击下方内容复制出处）

源文： OpenClaw 上下文超限问题修复 ...reserveTokensFloor to 20000 or higher. ，链接：https://www.daimagu.com/article/2604121440184480.html，来源：代码谷