A specialized skill for implementing, repairing, and optimizing the archived session lifecycle and UI within OpenClaw.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install archived-session-management
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 archived-session-management 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 Archived Session Management?
This Openclaw Skills entry provides a robust framework for managing the end-to-end lifecycle of archived chat sessions. It bridges the gap between the Control UI, gateway RPC handlers, and the underlying SQLite session history database to ensure users can seamlessly search, resume, or delete past interactions. By addressing common issues like database drift and inconsistent transcript paths, it ensures high reliability in session persistence.
The skill emphasizes backend integrity before UI polish, ensuring that search queries match critical metadata like session IDs and agent types. It also introduces idempotent restore logic, preventing failures during the transition of transcripts from archive storage back to active session directories while maintaining data consistency across the live session store.
Archived Session Management Use Cases
- Implementing a searchable archive for historical AI agent interactions.
- Repairing broken session resume flows where transcripts are missing or misplaced.
- Reconciling metadata inconsistencies between the SQLite database and the live session store.
- Optimizing UI performance for paginated archived session lists.
How Archived Session Management Works
- Analyzes the full communication chain from the gateway RPC methods to the session history SQLite index.
- Validates session existence across both the live sessions.json store and the physical transcript file paths.
- Executes idempotent restoration logic to move transcripts from archive to active status without metadata loss.
- Rebinds restored sessions to unique live keys to prevent overwriting active main threads.
- Synchronizes the UI state with the backend truth to provide accurate search and filtering results.
Archived Session Management Setup
To integrate this Openclaw Skills logic into your project, ensure your environment is configured for OpenClaw development and the database is accessible.
# Navigate to your OpenClaw directory
cd openclaw-core
# Ensure the session history database is initialized and migrated
npm run migrate:db
# Build the gateway to update RPC handlers
npm run build:gateway
Verify that the src/gateway/session-archive.ts and src/config/sessions/history-db.ts files are properly configured to handle the specific search and restore parameters outlined in the documentation.
Archived Session Management Data Schema & Taxonomy
The skill interacts with several data layers to ensure consistent session state management:
| Component | Source | Purpose |
|---|---|---|
| Session Index | SQLite (session_history) | Stores metadata like sessionId, status, and filePath. |
| Live Store | sessions.json | Maintains active session bindings and URI keys. |
| Transcripts | /sessions/archive/ | Physical JSON files containing the actual chat history data. |
| Search Keys | Metadata | Includes firstMessage, agentId, and chatType for easy discovery. |
Archived Session Management Advanced Features
- Idempotent restore logic that handles conflicting file paths automatically without throwing errors.
- Distinct live key rebinding (e.g., archive-sessionId) to maintain thread isolation and prevent UI jumps.
- Deep metadata search across multiple fields including sessionKey, displayName, and channel.
- Automated repair of legacy rows where database status and transcript file paths are out of sync.
SKILL.md
Loading
Related Openclaw Skills
Agent Memory System
A sophisticated memory architecture for AI agents featuring hierarchical storage, semantic retrieval, and automatic importance-based consolidation.
FlowZap Diagrams
A professional diagramming skill that converts natural language, code, or logs into valid FlowZap Code DSL with instant shareable playground URLs.
pilot-directory
Maintain a persistent local directory and metadata cache for frequently contacted AI agents.
pilot-dataset
A specialized skill for exchanging structured datasets with automated schema negotiation and metadata tracking over the Pilot Protocol.
API Documentation
A specialized AI agent skill designed to automate the generation, configuration, and versioning of high-quality API documentation.
AI Architect
A specialized assistant for designing robust AI system architectures, selecting technology stacks, and optimizing LLM performance and costs.
Featured*
