Pedro Gonzalez

Smart Context Manager

AI Agentv1.0.3
By Pedro GonzalezUpdated 2026-05-113 versions · latest released 2026-02-01context-manager@clawhub_plgonzalezrx8/context-manager
Agent FrameworksContext ManagementMemory#Context Management

According to AlphaMoat, as of 2026-10, Smart Context Manager has 10,780 downloads and 5 stars — ranked by downloads #2,532 among 10,914 AI skills in this ranking, and #345 of 1,632 in AI Agent.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
10.8K
Stars
5
Overall download rank
#2,532
Top 24% overall · Top 22% in AI Agent
PlatformDownloadsStarsComments
ClawHub ↗6.4K5-
SkillHub ↗10.8K5—

Platforms count differently and update at different times.

What this skill does

It has the agent summarise its own session, backs up the original session file, resets it the official way, and injects the summary as the first message of a fresh session so work continues under the same session key. It suits sessions where context use approaches 70% to 80% or the conversation turns slow and loses coherence; the --replace compression deletes the original session file and is destructive.

Profile published 2026-10-27

What you can do with it

  • Compress context before a long session slows down
  • Run only the summary to see what compression would drop

When to use it

  • Context usage is close to the limit
  • A long conversation must continue without losing its thread

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Compress this long session and then continue
Generate the summary only, do not reset the session

Monthly Trend

Downloads10.8K
4.5K7.9K11.2K2026-03 · Downloads 5.0K2026-05 · Downloads 5.7K2026-06 · Downloads 5.9K2026-07 · Downloads 6.2K2026-08 · Downloads 6.3K2026-09 · Downloads 7.0K2026-10 · Downloads 10.8K26-0326-0926-10
Stars5
4552026-03 · Stars 42026-05 · Stars 52026-06 · Stars 52026-07 · Stars 52026-08 · Stars 52026-09 · Stars 52026-10 · Stars 526-0326-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-1010.8K—5
2026-097.0K—5
2026-086.3K+2.5%5
2026-076.2K+4.1%5
2026-065.9K+3.4%5
2026-055.7K—5
2026-035.0K—4

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

8.0 KB · ClawHub v1.0.3
---
name: context-manager
description: AI-powered context management for OpenClaw sessions
user-invocable: true
---

# Context Manager Skill

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

Show all (226 lines)
## 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)

✅ AI Summary generated!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[AI-generated summary displayed]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 Resetting session and injecting compressed context...
  Backing up session file...
  Backup saved: memory/compressed/20260127-123146.session-backup.jsonl
  Deleting session JSONL to reset...
  Injecting compressed context into fresh session...
✅ Session compressed successfully!
  Old session ID: fc192a2d-091c-48c7-9fad-12bf34687454
  New session ID: a1b2c3d4-...
  Session is ready to continue with compressed context
```

**Result**: 70k tokens → 16k tokens (77% reduction)

## Output Files

When compression occurs, these files are created in `memory/compressed/`:

| File | Description |
|------|-------------|
| `{timestamp}.ai-summary.md` | AI-generated session summary |
| `{timestamp}.session-backup.jsonl` | Full backup of original session (can restore if needed) |
| `{timestamp}.transcript.md` | Raw transcript extraction (legacy) |
| `{timestamp}.summary.md` | Grep-based summary (legacy) |

## Requirements

- **openclaw** - Gateway must be running
- **jq** - JSON parsing (`brew install jq`)
- **Gateway access** - Script uses `openclaw agent` and `openclaw sessions`

## Technical Details

### Session Reset Method

The script uses JSONL deletion to reset sessions (official method):

1. Backup JSONL to `memory/compressed/`
2. Delete `~/.openclaw/agents/{agent}/sessions/{sessionId}.jsonl`
3. Send compressed context via `openclaw agent --to main`
4. New session is created automatically with summary as first message

### Why Not /reset?

The `/reset` slash command only works in the chat interface. When sent via `openclaw agent --session-id`, it's treated as a regular message and the agent tries to interpret it as a task.

### AI Summarization Prompt

The script asks the agent to provide:
1. What was accomplished (key tasks)
2. Key decisions made (with rationale)
3. Current state (where we left off)
4. Pending tasks (what still needs doing)
5. Important context (critical info to remember)

## Troubleshooting

### Summary Text Empty

If the AI summary extraction fails, check stderr redirect:
```bash
# The script uses 2>/dev/null to avoid Node deprecation warnings breaking JSON
openclaw agent --session-id $ID -m "..." --json 2>/dev/null
```

### Session Not Resetting

Verify the JSONL file path:
```bash
ls ~/.openclaw/agents/main/sessions/
```

### Restore From Backup

If something goes wrong:
```bash
cp memory/compressed/{timestamp}.session-backup.jsonl \
   ~/.openclaw/agents/main/sessions/{sessionId}.jsonl
```

### Check Logs

Use `openclaw logs` to troubleshoot:
```bash
openclaw logs --limit 50 --json | grep -i "error\|fail"
```

## Best Practices

1. **Backup first**: The script auto-backs up, but you can also manually backup before testing
2. **Test on non-critical sessions first**: Try on a Slack channel or cron session before main
3. **Check the summary**: Run `summarize` without `--replace` first to verify the summary quality
4. **Monitor token count**: Use `status` to verify compression worked

## See Also

- `openclaw sessions --help`
- `openclaw agent --help`

Popular in AI Agent

self-improving agentAI Agent

Records learnings, errors and corrections as Markdown files for later reuse and promotion into workspace memory.

↓ 1.6M★ 4.5Kpskoett
技能发现·Find SkillsAI Agent

Finds skills in local and remote catalogs from a plain-language request and recommends what to install.

↓ 1.6M★ 1.8K桂皮
Agent BrowserAI Agent

A browser-automation command line skill for AI agents.

↓ 1.2M★ 1.0KNicolas Kleiber
Self-Improving + Proactive AgentAI Agent

Turns corrections and self-review into tiered memory and promotes or archives it by use.

↓ 696.4K★ 1.6KIván
Proactive AgentAI Agent

A workspace setup guide for planning proactive follow-up, working memory and review routines for an AI agent.

↓ 579.3K★ 916halthelobster
Skill CreatorAI Agent

A guide to creating and updating effective Claude skills.

↓ 477.3K★ 485chindden
Skill VetterAI Agent

Reviews a third-party skill's source, permissions, and danger patterns against a checklist before it is installed.

↓ 445.2K★ 1.3Kspclaudehome
唐朝诗仙李白 · Ai Agent SkillAI Agent

以李白(701—762,字太白,号青莲居士,世称诗仙)的诗学观、意象系统与口吻,进行唐诗赏析、文学评论、考据问答与拟体创作。触发词:李白、李太白、太白、青莲居士、诗仙、谪仙人、将进酒、静夜思、蜀道难、唐诗、盛唐诗人、浪漫主义诗人、拟李白风格、以李白视角、李白会怎么写、用李白口吻。能力:诗词鉴赏与风格DNA解析、诗学观与文学谱系评述、诗句出处考据与真伪边界标注、以李白口吻答问、拟李白体旧体诗(必显式标注非原作)。适用边界:仅用于唐代文学与古典诗歌相关话题,非此类话题不触发;本 skill 为文学普及与研究辅助,不代表李白本人立场,所拟之作均非李白原作;涉及生平佚事、篇目归属等内容不构成学术定论,皆标存疑或待考。

↓ 435.8K★ 4user_ff4d9420

More from Pedro Gonzalez

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.