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

Security Scan

The skill's code, instructions, and requirements are consistent with its stated purpose of emitting a new-session trigger at 80% context usage; it does not request credentials, network access, or unusual installs.

Purpose & Capability

Name/description match the included script and SKILL.md. The single Python script and instructions are exactly what you'd expect for a threshold-based session-rotation helper; no unrelated binaries, env vars, or services are requested.

Instruction Scope

SKILL.md instructs the agent to read current context usage and call the bundled script with used/max tokens. The instructions do not ask the agent to read unrelated files, access credentials, or send data externally. They are specific and scoped to the purpose.

Install Mechanism

No install spec; the skill is instruction-only with a small included script. No downloads, package installs, or archive extraction are performed.

Credentials

The skill requests no environment variables, credentials, or config paths. The functionality (token ratio check → printed triggers) does not require secrets or external service access.

Persistence & Privilege

always is false and model invocation is allowed (default). The skill does not modify other skills or system settings and has no persistence or privileged installation steps.

Assessment

This skill appears coherent and low-risk: it simply computes used/max ratio and prints standardized trigger lines. Before installing, confirm how your agent supplies used_tokens and max_tokens (ensure those values come from the agent runtime and not untrusted input). Note that the script has no cooldown — repeated checks at or above threshold will repeatedly emit triggers, so integrate it into your heartbeat logic (or add a cooldown/state) to avoid spamming new-session events. If you require stricter guarantees, review/modify the script to add cooldowns, logging, or confidence checks appropriate to your platform.

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