Skills session-rotate-80

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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/0range-x/session-rotate-80" ~/.claude/skills/openclaw-skills-session-rotate-80 && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/0range-x/session-rotate-80" ~/.openclaw/skills/openclaw-skills-session-rotate-80 && rm -rf "$T"
manifest: skills/0range-x/session-rotate-80/SKILL.md
source content

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

  1. Read current context usage from runtime status.
  2. Run
    scripts/context_guard.py <used_tokens> <max_tokens>
    .
  3. If threshold reached, output the new-session trigger and handoff hint.
  4. 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:

  1. Call
    context_guard.py
    .
  2. If
    [ROTATE_NEEDED]
    , emit
    [NEW_SESSION]...
    directly.
  3. Stop handling new tasks in old session except handoff confirmation.

scripts/

  • scripts/context_guard.py
    : threshold detector and trigger emitter (no memory dependency).