什么是Context Guard
Context Guard 是一个专为 OpenClaw 智能体及其子代理设计的全自动上下文管理机制，旨在防止任务执行过程中因上下文溢出导致的遗忘、卡顿和 token 浪费。该协议通过融合自动监控、分区预算管理和压缩后恢复三大核心能力，构建了一个稳定可靠的对话与任务执行环境。其设计原则是‘防遗忘、防卡顿、防token浪费’，确保智能体在复杂多步任务中能够持续高效运行。
Context Guard 的核心理念是将有限的上下文资源进行结构化分配，并设定明确的水位线来触发保护性动作。它不依赖人工干预，而是在心跳（heartbeat）或会话启动时自动执行检查与响应，从而实现对上下文使用情况的动态掌控。无论是主代理还是子代理，均需严格遵守此协议，以保证整个系统的协同运作。
该机制特别强调信息持久化：所有关键决策、进度断点、新发现的数据都必须写入文件而非仅保留在对话流中。因为聊天内容随时可能被系统压缩或丢弃，唯有文件记录才能成为真正的‘记忆’。这使得 Context Guard 不仅是一种技术方案，更是一套可落地的操作规范。
核心功能特点
- 自动监控上下文水位，按预设比例分区管理资源
- 在50%水位时强制执行存档流程，包括STATUS.md、当日日志和MEMORY.md更新
- 支持模型降级以减缓context增长，避免进入危险区间
- 提供压缩后恢复机制，确保重启后能快速还原任务状态
- 严格限制子代理并行行为，防止浏览器等资源冲突
- 强制要求关键信息必须写入文件，杜绝口头承诺式记忆
适用场景
Context Guard 适用于需要长时间运行、多步骤协作的自动化任务场景，尤其适合那些涉及大量网络交互、数据提取或复杂逻辑判断的智能代理工作流。例如，一个负责监控多个DeFi合约状态并自动执行交易的代理，在执行过程中会不断接收新的区块数据和用户指令，若不对上下文加以控制，极易因信息过载而失效。此时，Context Guard 会在 context 达到50%时自动保存当前交易进度、已获取的关键地址和失败原因到 STATUS.md 和 memory 文件中，然后通知管理员重置会话，从而避免任务中断或资金损失。
另一个典型应用场景是浏览器自动化任务，如抓取网页内容、填写表单或监控价格变动。这类操作消耗上下文极快，尤其是当页面包含大量HTML或JSON数据时。根据协议，代理应在 spawn sub-agent 处理此类任务前评估 context 水位，并在任务完成后立即归档结果、清理缓冲区。如果子代理连续三次执行失败，则必须停止重试并上报原因，防止无意义循环占用资源。这种机制确保了即使面对高复杂度任务，系统仍能保持稳定可控。
此外，Context Guard 也适用于需要跨会话延续的任务，比如用户中途离开后返回继续操作。此时代理不会主动询问‘刚才做到哪了’，而是通过读取 STATUS.md、HEARTBEAT.md 及最近20条消息来重建上下文，并用一句话内部确认当前状态。这种方式既提升了效率，又避免了重复沟通带来的冗余开销，特别适合高频次、短周期的交互型服务。