Session Recall empowers AI agents to autonomously reconstruct conversation context from transcripts, cross-channel logs, and memory files.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agent-session-recall
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install agent-session-recall using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Session Recall?
The Session Recall skill is a sophisticated context-recovery layer designed to eliminate the friction of clarifying questions. By implementing a systematic search across session transcripts, memory files, and cross-channel history, this tool ensures that an AI agent remains oriented even when a user provides minimal context or resumes a conversation after long intervals. It is a vital component for developers building resilient Openclaw Skills that need to handle fragmented communication patterns.
This skill is particularly effective at solving the hidden context problem where users respond to automated cron notifications. Instead of failing to understand the reference, the agent proactively scans system logs to locate the origin of the message, providing a seamless and more human-like interaction experience.
Session Recall Use Cases
- Resuming conversations after a session reset or data compaction.
- Handling ambiguous user replies that lack immediate context.
- Reconstructing threads when a user references a topic from a different channel.
- Interpreting user responses to messages sent by automated cron jobs.
- Recovering conversation history when switching between different chat platform threads.
How Session Recall Works
- History Lookup: The skill first executes a fast check of recent messages using internal session history tools to find immediate matches.
- Transcript Analysis: It reads the local .jsonl session transcript, prioritizing the tail of the file for performance efficiency.
- Summary Review: The agent checks for user-maintained channel context summaries in the memory directory to identify ongoing themes.
- Cross-Channel Search: It performs a system-wide search using grep to find references to the current channel ID in other session logs, catching cron job outputs.
- Memory Integration: As a final check, it scans active context files and daily notes for relevant keywords.
- Specific Clarification: Only if all automated steps fail does it ask the user for clarification, citing exactly where it already searched.
Session Recall Setup
To enable Session Recall, ensure your agent has access to the sessions directory and the bundled search script. The default pathing assumes a standard installation for Openclaw Skills.
# Ensure the search script is executable
chmod +x ./scripts/search_sessions.sh
# Configure your agent to use the session-recall skill
# The skill relies on local file access to transcript logs
Session Recall Data Schema & Taxonomy
The skill interacts with the following file structure and data types to maintain state:
| Data Source | Path | Format |
|---|---|---|
| Session Transcripts | ~/.openclaw/agents/{agent}/sessions/*.jsonl |
JSON Lines |
| Channel Summaries | memory/channel_context/{channel-name}.md |
Markdown |
| Daily Notes | memory/YYYY-MM-DD.md |
Markdown |
| Global Context | memory/active_context.md |
Markdown |
| Session Metadata | sessions.json |
JSON |
Session Recall Advanced Features
- Cron Detection: Specialized logic to find messages sent by background processes that do not appear in the standard channel transcript.
- Performance Optimization: Uses tail-based reading for large JSONL files to reduce memory overhead and latency during recovery.
- Multi-Source Grep: Includes a bundled search script for rapid keyword matching across all archived sessions.
- Context Compaction Awareness: Automatically detects and searches .reset files generated during session compaction events to recover data beyond the current window.
SKILL.md
Loading
Related Openclaw Skills
Reelsmith
Reelsmith transforms topics, news, or articles into complete short-form vertical video packages optimized for social media platforms.
Humanize AI Text
A Python-based utility for detecting AI-generated writing artifacts and transforming text into natural, human-sounding prose.
Meeting Assistant
An automated AI agent skill for generating comprehensive meeting minutes, extracting actionable tasks, and managing project schedules.
Brain Trust Private Board
A dynamic multi-expert collaboration framework for strategic decision-making, red-teaming, and complex problem analysis.
ClawTipShopTester
A specialized AI writing assistant and payment integration tester for the Openclaw ecosystem.
Coding Agent
A powerful meta-agent skill that delegates complex development tasks to specialized AI agents like Codex and Claude Code using background bash processes.
Featured*
