← Back to Skills Marketplace
Session History Enhanced
by
maverick-software
· GitHub ↗
· v1.0.1
427
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install session-history-enhancements
Description
Session history system for OpenClaw — persistent, browsable, resumable chat sessions with SQLite index, archive/restore, migration, paginated UI, and chat dr...
Usage Guidance
This skill appears internally consistent and implements a local session-history feature. Before applying it: (1) back up your OpenClaw session directories (e.g., ~/.openclaw/agents/*/sessions/) because the migration and archive operations move and can delete transcript files; (2) review INSTALL.md and ensure your environment can build / has the SQLite/native node bindings referenced by the code (DatabaseSync); (3) test in a staging copy of your data first so you can confirm migration behavior; (4) be aware that the migration auto-runs on first access and will index/move orphaned .jsonl files — if you want to control timing, run migration manually or inspect the code first; (5) review the code snippets for any site-specific path usage if you run multiple agents, since operations are performed per-agentId. If you want extra assurance, ask for the missing INSTALL.md and a diff/PR that will be applied so you can review the exact changes before installing.
Capability Analysis
Type: OpenClaw Skill
Name: session-history-enhancements
Version: 1.0.1
The skill introduces a session history system with SQLite indexing and file management. While the primary functionality is benign and uses good practices like prepared statements for SQL and TypeBox for RPC input validation, there are theoretical vulnerabilities. Specifically, the `sessions.deleteArchived` RPC in `references/backend-rpc-handlers.ts.txt` uses `fs.unlinkSync(filePath)` to delete transcript files. Although `filePath` is derived from internal logic (`path.join` with controlled directories and filenames), a sophisticated path traversal vulnerability could theoretically lead to arbitrary file deletion if an attacker could inject a malicious path into the SQLite database. Similarly, `JSON.parse` is used on the first line of internal `.jsonl` transcript files in `references/backend-session-archive.ts.txt` and `references/backend-history-migration.ts.txt`, which could pose a risk if an attacker could introduce a specially crafted file. These are vulnerabilities (flaws that *allow* attacks) rather than clear evidence of *intentional malicious behavior*.
Capability Assessment
Purpose & Capability
The name/description match the provided SKILL.md and reference files: backend RPC handlers, SQLite history DB, migration, archive/restore logic, and frontend UI changes. No unrelated environment variables, binaries, or network endpoints are requested.
Instruction Scope
Runtime instructions and referenced code perform local filesystem operations (reading sessions.json, moving/renaming transcript .jsonl files into an archive folder, optionally deleting transcripts) and create/modify a local SQLite DB. These actions are coherent with a session-archival feature but are stateful and destructive (files moved/deleted) — migration auto-runs on first access and may move/or index orphaned .jsonl files.
Install Mechanism
This is an instruction-only skill (no install spec, no downloads). Risk from installation mechanism is low. Note: the referenced code uses a synchronous SQLite API (DatabaseSync from 'node:sqlite') which implies the project must already include/build the appropriate sqlite native bindings when you actually apply the changes.
Credentials
No environment variables, credentials, or external tokens are requested. All file/path access is scoped to OpenClaw's agent session directories and SQLite DBs, which is proportionate to the stated purpose.
Persistence & Privilege
The skill is not 'always: true' and doesn't request persistent platform-level privileges. It adds RPC handlers and UI wiring (normal for a feature patch). Autonomous invocation is allowed by default (platform behavior) but is not combined here with broad credentials or other red flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-history-enhancements - After installation, invoke the skill by name or use
/session-history-enhancements - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added direct archival of active sessions from the dashboard via an Archive button (excluding Main Session).
- Introduced the `sessions.archive` RPC endpoint to support on-demand session archiving.
- Updated UI to include Archive action, clearer Session History section, and enhanced pagination controls.
- Extended documentation for all 5 session history RPC endpoints and clarified their parameters and behavior.
- Improved dropdown integration: archived sessions selectable via a dedicated value format and with better filtering.
- Expanded Common Pitfalls and architectural notes to reflect new archive/resume workflow and dropdown usage patterns.
v1.0.0
Introduces persistent, browsable, multi-session history for OpenClaw with SQLite, dashboard UI, and chat dropdown integration.
- Adds SQLite-backed multi-session history, enabling session indexing, search, and pagination.
- Implements session archive/restore, resume, rename, and delete features.
- Full dashboard UI for browsing/searching archived and active sessions with paginated lists.
- Auto-migrates existing transcripts into the new history system.
- Integrates recent sessions into the chat dropdown with "View All Sessions" navigation.
Metadata
Frequently Asked Questions
What is Session History Enhanced?
Session history system for OpenClaw — persistent, browsable, resumable chat sessions with SQLite index, archive/restore, migration, paginated UI, and chat dr... It is an AI Agent Skill for Claude Code / OpenClaw, with 427 downloads so far.
How do I install Session History Enhanced?
Run "/install session-history-enhancements" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session History Enhanced free?
Yes, Session History Enhanced is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Session History Enhanced support?
Session History Enhanced is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session History Enhanced?
It is built and maintained by maverick-software (@maverick-software); the current version is v1.0.1.
More Skills