解决“413 Payload Too Large”：截图数据包过大时的配置优化
“同一个会话里截了十几张图，突然所有请求都返回 413 了……”
“前几次截图好好的，截到第 28 张就彻底卡死，会话直接废了……”
“更崩溃的是，截图保存在会话文件里，删又删不掉，整个会话只能废弃……”
如果你在用 OpenClaw 做网页自动化、爬虫调试或浏览器操作，你一定遇到过这种“截图撑爆会话”的问题。一个含 28 张截图的会话文件能膨胀到 5.33MB，其中图片数据占了 3.52MB（约 88%）。当这些图片数据随每次 API 请求一起发送时，超过接口大小限制，就会触发413 Payload Too Large，整个会话彻底瘫痪。
今天这篇文章，就从 413 错误的根源出发，拆解 OpenClaw 内置的压缩与清理机制，并给出从升级到配置的一站式解决方案。读完这篇，你就能让截图数据不再“压垮”会话。
一、先弄懂：为什么截图多了会报 413？
1.1 会话文件里的“隐形胖子”
OpenClaw 的每个会话都会保存完整的对话逐字稿（transcript）。当你使用browser工具截图或调用camera快照功能时，图片会以 Base64 格式直接存入会话文件。
一张截图 Base64 编码后通常是100KB-300KB。存 10 张就是 1-3MB，存 28 张就是 3.5MB+。每次与大模型 API 交互时，整个会话文件都会被当作上下文发送出去。一旦超过 API 的大小限制（不同服务商阈值不同，常见为 4MB-10MB），就会返回 413 错误，且该会话无法再使用。
1.2 413 错误的核心成因
| 成因 | 说明 |
|---|---|
| 图片 Base64 占满会话 | 截图越多、分辨率越高，会话文件越大 |
| 旧版本无自动清理 | v2026.2.x 之前的版本不会自动压缩图片数据 |
| API 大小限制 | 大模型接口对单次请求有 Payload 上限 |
好消息是：OpenClaw 在v2026.2.x 之后已经通过 PR #5817 修复了这个问题。如果你还在用旧版本，升级并触发一次压缩就能立刻恢复。
二、核心解决方案：三步搞定 413 错误
第一步：立即恢复（会话已报 413）
如果你的会话已经卡死在 413 错误，不要废弃会话，执行一条命令即可恢复：
/compact这会触发 OpenClaw 的上下文压缩（Compaction）机制。修复后的版本会在压缩时自动保留最近 3 条含图片的消息，更早的图片会被替换为文本占位符：
[Image omitted during compaction: image/jpeg, ~150KB]会话文件体积会瞬间从 5MB+ 降到几百 KB，会话立即恢复可用。
第二步：升级到最新版本（防患于未然）
旧版本（v2026.2.x 之前）不会自动清理历史图片数据，每次截图都会永久累积。升级后，每次压缩都会自动清理旧图片，让会话体积持续保持健康。
# 检查当前版本 openclaw --version # 升级到最新版本 npm update -g @openclaw/openclaw # 升级后确认版本 openclaw --version # 应显示 v2026.3.28 或更高第三步：配置自动压缩策略
升级后，建议在config.yaml或openclaw.json中配置主动压缩阈值，避免上下文在撑满后才压缩（撑满后每次请求都会很慢）：
{ "agents": { "defaults": { "compaction": { "triggerAtPercent": 75, // 上下文使用率达75%时自动压缩 "model": "claude-haiku-4-5-20251001" // 用轻量模型执行压缩，节省主模型 token }, "params": { "max_tokens": 4096 // 按实际需要设置，避免单次生成过长 } } } }关键原则：压缩触发阈值设为 75-80%，用轻量模型（如 Haiku）执行压缩任务，避免主模型 token 浪费。
三、进阶：会话修剪与自动清理机制
除了主动/compact，OpenClaw 还内置了会话修剪（Session Pruning）机制，能在每次 LLM 调用前自动裁剪旧的工具结果（包括历史截图数据）。
3.1 修剪的工作原理
| 机制 | 作用 |
|---|---|
| 软修剪 | 对过大的工具结果，保留开头和结尾，中间插入... |
| 硬清除 | 将非核心内容替换为占位符 |
| 图片清理 | 在重播视图中，将已处理的旧图片替换为[image data removed - already processed by model] |
修剪不会重写原始会话逐字稿，只影响后续请求中发送给模型的内容，因此历史查看器仍能看到原始记录，但 API 请求不再携带海量图片数据。
3.2 修剪 vs 压缩
| 对比维度 | 修剪（Pruning） | 压缩（Compaction） |
|---|---|---|
| 处理内容 | 裁剪工具结果（如图片数据） | 用 AI 摘要整个对话 |
| 是否持久化 | 否（每次请求独立处理） | 是（摘要写入会话逐字稿） |
| 覆盖范围 | 仅工具输出 | 整个对话 |
两者相辅相成：修剪让工具输出保持精炼，压缩让对话摘要保持精简。
四、日常预防建议
除了升级和配置压缩策略，日常使用中注意以下几点，可以大幅降低 413 复现概率：
周期性执行 /compact：尤其是截图密集的任务，建议每 10-20 张截图手动触发一次压缩
控制截图分辨率：在采集指令中明确要求“低分辨率截图”或“仅截取可见区域”
定期清理无效会话：不需要的历史会话直接删除，避免磁盘和内存占用
监控会话文件大小：周期性检查
~/.openclaw/workspace/sessions/目录，超过 2MB 的会话主动处理
五、站大爷隧道代理的配合
在解决 413 错误的过程中，站大爷隧道代理虽然不直接修复图片膨胀问题，但能提供稳定的网络环境，让升级、压缩操作不受代理波动干扰。
环境变量配置法（最稳）：
# Mac/Linux export HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" export HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" openclaw gateway start# Windows PowerShell $env:HTTP_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" $env:HTTPS_PROXY="http://隧道ID:密码@tps.zdaye.com:8080" openclaw gateway start站大爷隧道代理 24 小时连接成功率 99.3%，故障自愈 <30 秒。稳定的网络环境让压缩、升级操作不会因为代理中断而失败。
总结
413 Payload Too Large 的核心病因是截图 Base64 数据在会话文件中无限累积，导致 API 请求超限。
解决方案三件套：
立即恢复：
/compact一键压缩，自动保留最近 3 张截图，清理历史图片数据版本升级：升级到 v2026.3.28 或更高，获得自动清理能力
主动防御：配置
compaction.triggerAtPercent: 75，让系统在会话撑满前主动压缩
截图再多，只要会压缩，会话就不会“撑死”。配合站大爷隧道代理的稳定网络环境，你的 OpenClaw 采集任务就能告别 413 的困扰。