Bounded Memory

Provides fast full-text search of OpenClaw session histories with optional LLM summarization for recalling past conversations and decisions.

Gives your OpenClaw AI agent a perfect memory — it can recall anything you've ever discussed, even from months ago.

What It Does

Without this skill: each OpenClaw session starts fresh. The AI forgets everything.

With this skill: ask things like:

• "Did we discuss X before?"
• "What did we decide about Y?"
• "Find that conversation from last month"

Privacy Design

What runs	How
Search indexing	✅ 100% offline — SQLite only
Search execution	✅ 100% offline — no network calls
LLM summarization	⚠️ Opt-in only — use --llm flag to enable

No external API calls by default. The --llm flag (disabled by default) sends snippets to your configured LLM for summarization — only when you explicitly ask for it.

Quick Start

# Index your conversations (first time)
python3 skills/session-search/scripts/index-sessions.py --agent main

# Search (fully offline)
python3 skills/session-search/scripts/search-sessions.py "what did we decide about the logo design"

# Search with AI summary (opt-in)
python3 skills/session-search/scripts/search-sessions.py "question" --llm

What It Solves

Problem	Without	With Bounded Memory
"I asked this before but can't remember"	AI has no idea	Instant recall
"What did we decide in that meeting?"	Forgot	Searches all sessions
"Did I mention this before?"	No way to know	Searches everything

Example

You: "Search our conversations about the robot project"
→ Found 3 discussions:
  1. [Last week] We discussed the design direction...
  2. [2 weeks ago] You asked about pricing...
  3. [Last month] The AI suggested adding...