prompt-compressor

name

prompt-compressor

description

Saves 20-40% of LLM tokens by teaching the agent to write compressed responses, compressed memory logs, and compressed pre-compaction summaries. Works via SOUL.md instructions — no hooks, no extra process, no dependencies. Also provides explicit compression when the user asks to compress a prompt. Use when the user asks about reducing token costs, optimizing API spend, compressing prompts, or making the agent more efficient.

Prompt Compressor

Saves tokens on turns 2+ by making all agent output compressed from the start.

How it works

This is NOT a hook (hooks require newer OpenClaw versions). Instead, it works by adding instructions to SOUL.md that make the agent:

1. Write compressed responses — no filler, no hedging, lead with answers
2. Write compressed MEMORY.md — one fact per line, no narrative
3. Write compressed daily logs — decisions only, not discussions
4. Compress pre-compaction flushes — facts not paragraphs

The savings compound: compressed responses → compressed history → compressed compaction summaries → fewer tokens on every subsequent turn.

Install

Append the contents of soul-snippet.md to the user's SOUL.md:

cat {baseDir}/soul-snippet.md >> ~/.openclaw/SOUL.md

Or if using a workspace SOUL.md:

cat {baseDir}/soul-snippet.md >> <workspace>/SOUL.md

Then start a new session (/new) so the updated SOUL.md loads.

When user asks to compress a specific prompt

Apply these rules manually to their text:

Remove

• Greetings: "Hello", "Hi", "Hey", "Good morning"
• Sign-offs: "Thanks", "Best regards", "Cheers"