context-manager

Files (5)

• origin.json · .clawhub/
• SKILL.md
• _meta.json
• compress.sh
• config.json

SKILL.md (first lines)

# Context Manager Skill

- Author: Daniel Li
- Copyright © Daniel Li. All rights reserved.

AI-powered context management for OpenClaw sessions. Uses the agent itself to generate intelligent summaries, then resets the session with compressed context.

## Quick Start

```bash
# List all sessions with usage stats
~/openclaw/skills/context-manager/compress.sh list

# Check status of a specific session
~/openclaw/skills/context-manager/compress.sh status agent:main:main

# Generate AI summary (read-only, safe)
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main

# Compress session: generate summary, reset, inject (DESTRUCTIVE)
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main --replace
```

## When to Use

- Context usage approaching 70-80%+
- Long sessions with extensive conversation history  
- Before the session becomes slow or loses coherence
- Proactively to maintain fast, focused sessions

## How It Works

1. **AI Summarization**: Sends a prompt to the agent asking it to summarize its own context
2. **Backup**: Saves the original JSONL session file to `memory/compressed/`
3. **Reset**: Deletes the JSONL file (official reset method)
4. **Inject**: Sends the AI-generated summary as the first message in the fresh session
5. **Result**: Same session key, new session ID, compressed context

**Key insight**: The agent has full visibility into its own context, so it generates the best possible summary.

## Commands

### Session Commands

| Command | Description |
|---------|-------------|
| `list` | List all sessions with token usage |
| `status [KEY]` | Show detailed status for a session |
| `summarize [KEY]` | Generate AI summary (read-only) |
| `summarize [KEY] --replace` | Summarize AND reset session with compressed context |
| `compress [KEY]` | Legacy grep-based extraction (not recommended) |
| `check [KEY]` | Check if session exceeds threshold |
| `check-all` | Check all sessions at once |

### Configuration Commands

| Command | Description |
|---------|-------------|
| `set-threshold N` | Set compression threshold (50-99%, default: 80) |
| `set-depth LEVEL` | Set depth: brief/balanced/comprehensive |
| `set-quiet-hours HH` | Set quiet hours (e.g., "23:00-07:00") |
| `help` | Show help and usage examples |

## Examples

### List All Sessions

```bash
$ ~/openclaw/skills/context-manager/compress.sh list
📋 Available Sessions (4 total)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#    SESSION KEY                              KIND       TOKENS    USAGE
1    agent:main:main                          direct      70188      70%
2    agent:main:slack:channel:c0aaruq2en9     group       20854      20%
3    agent:main:cron:0d02af4b-...             direct      18718      18%
```

### Check Session Status

```bash
$ ~/openclaw/skills/context-manager/compress.sh status agent:main:main
📊 Context Manager Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Session Key: agent:main:main
  Session ID:  fc192a2d-091c-48c7-9fad-12bf34687454
  Kind:        direct
  Model:       gemini-3-flash
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Threshold:   80%
  Tokens:      70188 / 100000
  Usage:       70%
```

### Generate AI Summary (Safe, Read-Only)

```bash
$ ~/openclaw/skills/context-manager/compress.sh summarize agent:main:main
🧠 Requesting AI summary for session: agent:main:main
  Session ID: fc192a2d-091c-48c7-9fad-12bf34687454

✅ AI Summary generated!
  Saved to: memory/compressed/20260127-123146.ai-summary.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
### Session Summary: January 27, 2026

#### 1. What was accomplished
- System audit completed
- Essay generation with sub-agents
...
```

### Full Compression (Summarize + Reset + Inject)

```bash
$ ~/openclaw/skills/context-manager/compress.sh summarize agent:main:main --replace
🧠 Requesting AI summary for session: agent:main:main
  Session ID: fc192a2d-091c-48c7-9fad-12bf34687454
  Mode: REPLACE (will reset session after summary)

From aAAaqwq/AGI-Super-Team, MIT.

More from aAAaqwq/AGI-Super-Team