Skip to main content
Generaldvcrn

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.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--session-rotate-80
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/0range-x--session-rotate-80/skills/session-rotate-80/SKILL.md -o .claude/skills/session-rotate-80.md

Drops the SKILL.md into .claude/skills/session-rotate-80.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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).