Context Guard

防遗忘防卡顿的context管理协议。自动监控水位、分区管理、压缩前存档、压缩后恢复。适用于所有OpenClaw agent和sub-agent。在heartbeat或session启动时触发。

Security Scan

The instructions match a context-management purpose, but the skill directs reading/writing several specific agent files and channel history without declaring those config paths, and it could cause sensitive data (addresses, balances, TX hashes) to be written to disk—this mismatch and data-risk warrant caution.

Purpose & Capability

Name/description and the runtime instructions are coherent: this is a context-management protocol that monitors context 'waterline', checkpoints state to files, and restores after compression. However, the metadata declares no required config paths or files, while the SKILL.md explicitly expects/uses files such as SOUL.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md, STATUS.md and HEARTBEAT.md. The absence of declared config paths is an inconsistency (the skill expects file read/write access but metadata doesn't state it).

Instruction Scope

SKILL.md instructs agents to run platform commands (session_status), read channel history (message action=read limit=20), and create/append multiple files containing critical state and possibly sensitive items (addresses, wallet balances, TX hashes). Those actions are within the stated purpose but expand scope to persistent storage of potentially sensitive data and to reading user/channel history. The instructions are prescriptive (must checkpoint at 50%), and require modifying HEARTBEAT.md to integrate, which affects agent runtime behavior. The skill does not describe safeguards (encryption, access controls, or retention policy) for stored sensitive data.

Install Mechanism

Instruction-only skill with no install spec and no code files; nothing is written to disk by an installer. Lower risk from install mechanism.

Credentials

No environment variables or credentials are requested (good). However, the instructions call for writing and reading files that may contain secrets; because no config paths or permissions are declared, it's unclear what filesystem locations and permissions will be used and whether stored data will be protected. The number of 'implicit' file accesses is nontrivial relative to the simple metadata.

Persistence & Privilege

always:false (normal). The skill recommends modifying HEARTBEAT.md to run each heartbeat check — that implies persistent integration into agent heartbeat behavior, but this is an instruction rather than an enforced install. It does not request persistent elevated privileges or autonomous always-on inclusion, but integrating into heartbeat increases its runtime footprint and frequency of execution.

What to consider before installing

This skill appears to do what it says (automatic context checkpointing and recovery), but it expects to read and write specific agent files and message history even though the registry metadata doesn't declare those file paths. Before installing or enabling it, consider: - Confirm where SOUL.md, USER.md, MEMORY.md, STATUS.md, HEARTBEAT.md and memory/YYYY-MM-DD.md will be stored and who can read them; ensure filesystem permissions and retention policies are acceptable. - Ask the author to declare required config paths in metadata and to document any protection (encryption, ACLs) for sensitive entries (wallet addresses, TX hashes, balances). - Verify the platform commands referenced (session_status, message action=read) exist and have the expected behavior and permissions in your environment. - If you handle sensitive data, test in a safe environment first and limit what the skill is allowed to persist (avoid storing full JSON/HTML or private keys; keep only minimal restart data). - If you want stricter control, request the skill be updated to: explicitly list required paths, provide an opt-in heartbeat integration step, and include explicit data handling rules (scrubbing/encryption/TTL) for saved files.

全自动context管理 — 防遗忘、防卡顿、防token浪费。

融合了 context-sentinel（自动监控）、context-budgeting（分区+checkpoint）、context-recovery（压缩后恢复）三个方案的优点，去掉了它们的缺陷。

---

1. Context分区预算

每次session的context是有限资源，按以下比例分配：

分区	占比	内容
核心指令	10%	SOUL.md + USER.md + 当前任务目标
近期对话	40%	最近5-10轮对话
决策日志	20%	"试了X，因为Y失败" 这类关键记录
背景知识	20%	MEMORY.md中与当前任务相关的片段
缓冲区	10%	留给工具输出和突发需求

原则： 大段工具输出（JSON、网页内容等）提取关键信息后不要保留原文。Browser snapshot用完即弃。

---

2. 水位监控与行动

在每次回复前，agent应评估当前context水位并执行对应动作：

水位线

水位	状态	动作
0-40%	🟢 安全	正常工作
40-50%	🟡 注意	精简回复，避免大段输出，重活spawn sub-agent
50-55%	🟠 预警	立即执行存档流程（见第3节）
55-60%	🔴 危险	存档完成 → 通知Russ执行 /new
60%+	🚨 禁区	停止一切非存档操作，立即存档+通知

自动检查方法

在heartbeat或感觉context变大时，运行：

session_status

读取返回的context百分比，按上表行动。

Model降级（可选）

如果Russ暂时无法 /new，agent可以自行降级model减缓context增长：

当前model	context > 50%	context > 60%
opus-4-6	切换到 sonnet	停止工作，等reset
sonnet	继续	停止工作，等reset

降级命令：session_status model=<model_name>

---

3. 存档流程（Checkpoint）

到50%水位时必须执行，不需要等Russ确认：

Step 1: STATUS.md — 任务断点

# STATUS.md
Updated: YYYY-MM-DD HH:MM

## 当前任务
[在做什么]

## 进度
[做到哪了，关键步骤完成情况]

## 阻塞
[卡在哪 / 无]

## 下一步
[接下来该做什么，越具体越好]

## 关键数据
[地址/金额/TX hash/URL等，任何重启后需要的具体数据]

Step 2: memory/YYYY-MM-DD.md — 当天日志

追加写入，不覆盖：

• 今天做了什么（关键决策和结果）
• 新发现的信息（合约地址、API endpoint等）
• 犯的错误和教训
• 只写重启后需要的信息，不写废话

Step 3: MEMORY.md — 长期记忆（如有）

只在有长期价值的信息时更新：

• 新策略、新工具、新教训
• 钱包余额重大变动
• 重要决策和原因
• 人物关系、偏好变化

Step 4: 通知Russ

存档完成后发一条消息：

"总裁，context到X%了，已存好档（STATUS.md + memory已更新）。帮我 /new 🙏"

注意： Agent不能自己reset，必须Russ手动 /new。

Step 5: 压缩后通知（必须）

如果context被系统自动压缩了，恢复后第一条消息必须告诉Russ：

"刚刷新了，context从X%压缩了。记忆已从文件恢复，没丢东西。"

这条规则没有例外。 每次刷新都要通知。

---

4. 压缩后恢复（Recovery）

当新session启动或检测到context被压缩时，执行恢复流程：

触发条件

• Session以 <summary> 标签开始（自动压缩）
• 用户说"继续"、"刚才做到哪了"
• Agent感觉缺少上下文

恢复步骤

1. 读文件（标准启动流程）：

   • SOUL.md → 我是谁
   • USER.md → 我服务谁
   • MEMORY.md → 长期记忆（仅主session）
   • memory/YYYY-MM-DD.md → 今天+昨天日志
   • STATUS.md → 进行中的任务
   • HEARTBEAT.md → 待检查事项

2. 读channel历史（如果文件不够还原上下文）：

   message action=read limit=20
   

   从最近20条消息中提取：最后的用户请求、未完成的操作、关键URL/地址

3. 合成上下文，用一句话内部确认：

   "上次做到[X]，当前状态是[Y]，下一步是[Z]"

4. 继续工作，不需要问用户"我们刚才在做什么"

---

5. Sub-Agent规则

什么时候spawn

• 浏览器操作（吃context最快）
• 长时间research / 大量网页抓取
• 任何预计消耗 >20% context的任务

Sub-Agent也遵守本协议

• 同样的水位线和存档流程
• 做完任务 → 结果写文件 → 汇报主session → 结束
• 失败3次就停，上报原因，不死循环

资源互斥

• 同一时间只有一个agent用browser profile "openclaw"
• 多个browser任务 → 排队执行，不并行

---

6. 绝对禁止

1. ❌ 只在聊天里说重要信息不写文件 — 聊天会压缩/丢失
2. ❌ Context超60%还在做重操作 — 先存档先reset
3. ❌ Sub-agent无限重试 — 3次失败就停
4. ❌ 说"我记住了"但没写文件 — 没写 = 没记
5. ❌ 多agent同时用同一个browser profile
6. ❌ 大段JSON/HTML原文留在context里 — 提取关键信息后丢弃

---

7. Heartbeat集成

在 HEARTBEAT.md 中加入：

### 🛡️ Context Guard（每次heartbeat必查）
1. `session_status` 检查context水位
2. 按水位线执行对应动作
3. 如果 >50%，执行存档流程

---

v1.0.0 — 2026-02-12 by Echo 适用于所有OpenClaw agent及sub-agent