OpenHands 上下文管理快速指南3 步解决上下文超限报错多轮对话不再中断【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands长文档分析到一半agent 突然抛出input length and max_tokens exceed context limit或者你和它来回聊了几轮之后任务直接以历史溢出的错误中断——这就是 OpenHands 上下文管理里最常见的一道坎对话历史累积超出了模型的上下文窗口。好消息是OpenHands 内置了自动历史截断照着下面配置对话就能继续跑下去。✅ 三步开启最省心的上下文管理配置如果你只想用 30 秒解决问题保留下面这组默认值就行——历史截断默认开启不改也能用这一节只是帮你确认它没被误关。# [agent] 是 agent 行为的配置段别写错位置 [agent] # 截断总开关窗口即将超限时自动修剪对话历史 enable_history_truncation true # 压缩策略默认 NoOp日常使用无需改动 condenser NoOpCondenserConfig以上是你在 config.template.toml 里需要碰的全部参数逐项含义enable_history_truncation截断总开关。系统检测到上下文即将超限时自动修剪对话历史以维持会话连续性。condenser历史压缩策略默认就是NoOpCondenserConfig不需要动。[agent]这两项参数所在的配置段写错段名会直接不生效。一张图看懂截断是怎么发生的一句话结论报错发生时系统不是直接把错误甩给你而是先减重——保近期、压历史、再重发请求。大白话就是开关在整个过程你几乎无感——最近几轮完整保留早期内容压成摘要任务接着干开关关了错误就会原样弹到你脸上会话就此中断。图里的历史就是下面这种不断堆起来的会话列表每一轮都在吃窗口额度⚠️ 还是报错常见坑与修复对照先对照下表——报错原文都定义在 openhands/core/exceptions.py对得上哪条就修哪条报错原文原因一句话修复动作input length and max_tokens exceed context limit单次输入比如一次贴入的长文档加上本轮输出上限已超出模型窗口把文档拆成几段分轮对话或在配置里调小max_tokens给历史留出余量Conversation history longer than LLM context window limit多轮历史撑爆窗口而自动截断处于关闭状态把enable_history_truncation设回true重启服务会话即可自动恢复改了配置还是报错改错了文件或者改动根本没生效确认改动落在 config.template.toml 的[agent]段保存后重启 OpenHands想更精细自定义压缩策略扩展点默认策略对绝大多数人够用只有当你有明确诉求时才需要自己写——比如只保留最近 3 轮、更早的全部摘要化这类针对长文档或特定模型的压缩要求。扩展点很小继承 openhands/memory/condenser/ 里的基类、实现压缩方法即可# 继承 abstract_condenser.py 中定义的压缩器基类 class ClaudeOptimizedCondenser(AbstractCondenser): # 压缩入口自定义策略例如只保留最近 3 轮更早的摘要化 def compress(self, history): return compressed_history具体怎么注册、参数怎么传不用纠结——默认策略能覆盖大多数场景等发现默认截断切掉了你还需要的内容时再回来研究这个接口也不迟。OpenHands 的上下文管理其实不复杂截断开关保持开启、报错时知道系统做了什么、默认策略不满足时找压缩器扩展点这三点就是全部。按上面的步骤走完上下文超限导致的任务中断基本可以告别。想深入原理可以看官方开发文档 docs/DEVELOPMENT.md配置细节和扩展机制都有更完整的说明。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考