龙虾上下文 16k 解决方案#
龙虾报错 API rate limit 还有这个
Context limit exceeded. I've reset our conversation to start fresh - please try again.
To prevent this, increase your compaction buffer by setting agents.defaults.compaction.reserveTokensFloor to 20000 or higher in your config.
是本地上下文配置为 16 k,需要自行修改
OpenClaw 的模型上下文大小不是固定 16k,主要看本地配置。请检查 ~/.openclaw/openclaw.json 或 ~/.openclaw/agents/< agentId>/agent/models.json,把对应模型的 contextWindow 和 maxTokens 改成模型实际支持值。以 MiniMax-M2.5 为例,可改为 contextWindow: 196608、maxTokens: 8192。修改后重启 OpenClaw 即可。官方配置参考与 MiniMax 示例都支持这种写法。方法一:web页面配置那搜索 contextWindow 然后改成128000#
方法二:OpenClaw 修改上下文配置说明#
一、问题现象#
如果在 OpenClaw 中接入自定义模型或第三方中转模型时,模型配置里的上下文窗口写得太小,例如:就可能出现以下问题:
长对话容易失败
工具调用时更容易报错
页面提示 API rate limit reached
模型明明支持更大上下文,但 OpenClaw 仍按较小值处理
OpenClaw 官方文档说明,模型的 contextWindow 和 maxTokens 可以在配置中显式设置;主配置文件路径为 ~/.openclaw/openclaw.json,也可以在 agent 目录下使用 models.json 单独覆盖。二、配置文件位置#
1)主配置文件路径#
2)Agent 模型配置路径#
官方文档写明:自定义 provider 可以加在 models.providers 中,或者写在 ~/.openclaw/agents/< agentId>/agent/models.json。3)如果改过自定义 Agent 根目录#
那么 agent 配置目录会被这个环境变量覆盖。官方文档也写了可通过 OPENCLAW_AGENT_DIR(或 PI_CODING_AGENT_DIR)修改 agent 配置根目录。三、怎么改#
方案 A:改主配置#
官方 MiniMax 示例里给出的 MiniMax-M2.5 配置就是 contextWindow: 196608、maxTokens: 8192。方案 B:改 agent 下的#
四、建议怎么填#
这个别乱填,别搞成“我希望它 1M 上下文所以我就写 1000000”,宇宙不是这么运行的。推荐原则#
contextWindow:按模型真实支持值填写
maxTokens:按模型真实最大输出填写
如果你接的是中转平台,要看中转实际放行的上限,不是只看原厂宣传值以 MiniMax-M2.5 为例#
五、修改后要 做什么#
建议修改前先把龙虾停止:先openclaw gateway stop停止
然后修改配置
保存配置后,重启 OpenClaw 或对应 gateway 进程。
常见可用命令:官方文档也给了这两个命令用于检查和切换模型。
如果你是通过服务方式运行,还需要重启对应服务,例如:或者重启你自己的 systemd / pm2 / docker 容器。六、补充说明#
OpenClaw 官方配置参考还提到:
自定义 provider 可以直接写到 models.providers
contextWindow / maxTokens 支持显式设置
对匹配模型时,会在显式配置和隐式 catalog 之间取更高值
若要完全用你自己的配置覆盖 models.json,可用 models.mode: "replace"。另外,官方文档现在写的是:对于 custom providers,如果这些字段省略,默认会给到 contextWindow: 200000、maxTokens: 8192。所以如果你客户那里还是 16k 或 4k,多半不是“OpenClaw 现在默认只能 16k”,而是他们本地模型配置被手动写小了,或者旧配置残留。修改于 2026-04-13 08:53:54