| name | session-rotate-80 |
| description | Auto-create a new session when OpenClaw context usage reaches 80% without requiring Mem0 or file memory systems. Use when users want default OpenClaw to proactively rotate sessions and avoid context overflow in long chats. |
Session Rotate 80
Overview
Trigger a standard [NEW_SESSION] message when context usage reaches 80%.
This skill is memory-system-agnostic and works in plain default OpenClaw setups.
Workflow
- Read current context usage from runtime status.
- Run
scripts/context_guard.py <used_tokens> <max_tokens>.
- If threshold reached, output the new-session trigger and handoff hint.
- Keep old session only for short handoff, then continue in new session.
Command
python scripts/context_guard.py <used_tokens> <max_tokens> --threshold 0.8 --channel boss
Example:
python scripts/context_guard.py 220000 272000 --threshold 0.8 --channel boss
Expected Output
At or above threshold:
[ROTATE_NEEDED][NEW_SESSION] 上下文达到80%（used/max），自动切换新会话[HANDOFF_HINT] ...
Below threshold:
[ROTATE_NOT_NEEDED] ratio=x.xx < 0.800
Integration Hint (Heartbeat)
In heartbeat flow, after reading context usage:
- Call
context_guard.py.
- If
[ROTATE_NEEDED], emit [NEW_SESSION]... directly.
- Stop handling new tasks in old session except handoff confirmation.
scripts/
scripts/context_guard.py: threshold detector and trigger emitter (no memory dependency).
