← Back to Skills Marketplace
18940111404

Session Archive

by 18940111404 · GitHub ↗ · v0.4.1 · MIT-0
cross-platform ✓ Security Clean
233
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install session-archive
Description
Automatically saves conversation messages to a SQLite database with query and model usage statistics functionality.
README (SKILL.md)

Session Archive Skill

描述

会话存档插件 - 自动将对话消息保存到 SQLite 数据库。

功能

  • 实时保存对话消息
  • 支持按会话、日期查询
  • 统计模型使用情况

使用方法

此为底层插件,安装后自动生效,无需手动调用。

配置

  • 数据库路径:~/.openclaw/session-archive.db
  • 可在 openclaw.json 中自定义配置
Usage Guidance
This plugin appears to do what it claims: archive all conversation messages into a local SQLite file (default: ~/.openclaw/session-archive.db). Before installing, consider: 1) the database will contain full conversation content (sensitive) — restrict filesystem permissions, and back up or encrypt the DB if needed; 2) better-sqlite3 is a native dependency that may require build tools on some systems — ensure your environment can install it; 3) review/confirm the dbPath in openclaw.json so data isn't written to an unexpected location; 4) if you need stronger guarantees, inspect the included source files (they are present) and confirm no network calls were added in later versions. Overall the package is internally consistent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill Name: session-archive Version: 0.4.1 The session-archive skill bundle is a utility designed to log conversation history, token usage, and system operations into a local SQLite database (~/.openclaw/session-archive.db). The implementation in src/db.ts and src/engine.ts uses standard database practices with better-sqlite3 to record metadata such as message roles, content, and tool calls. There is no evidence of data exfiltration, obfuscation, or unauthorized command execution; the plugin's behavior is entirely consistent with its stated purpose of providing a persistent record of agent activity.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the plugin registers a context engine that ingests messages and writes them into a local SQLite DB. The declared config (dbPath) and default (~/.openclaw/session-archive.db) are consistent with the code. The operations/token usage tables are for logging and analytics and align with the README.
Instruction Scope
SKILL.md says the plugin runs automatically and stores messages to SQLite; the runtime code shows only ingestion, query, and token-estimation functions. It does not read unrelated system files, contact external endpoints, or execute shell commands. It records provided operation metadata but does not itself perform 'exec' or other system actions.
Install Mechanism
There is no external install URL; the package includes source and dist JS. package.json depends only on better-sqlite3 (a native SQLite binding). The presence of a large package-lock is notable but not evidence of malicious downloads; better-sqlite3 may require native build tools on install/runtime depending on environment.
Credentials
The plugin requests no environment variables or credentials. Its sole filesystem interaction is creating/using a DB under the user's home (~/.openclaw). That is proportionate to its function of archiving conversations.
Persistence & Privilege
always is false and the plugin registers itself as a context engine (expected for this kind of plugin). It does not attempt to modify other plugins' configuration or system settings beyond registering itself; its DB is per-user and written to the home directory.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install session-archive
  3. After installation, invoke the skill by name or use /session-archive
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.4.1
- Updated package version to 0.4.1. - No user-facing changes; documentation and core functionality remain unchanged.
v0.4.0
- Internal codebase updated across database and engine modules. - Prepared for future improvements; no end-user features added or changed.
v0.3.0
- Improved codebase with multiple file updates for enhanced maintainability. - Updated type definitions in db and engine modules. - Adjusted build outputs in dist directory. - Refreshed dependencies in package.json. - Documentation remains unchanged with no updates to SKILL.md.
v0.2.0
- Improved database code structure in both TypeScript and JavaScript implementations. - Updated core logic in engine files for better session archiving. - Internal refactoring: function definitions and type declarations were clarified across database modules. - No changes to user configuration or usage instructions.
v0.1.0
Session Archive Skill 0.1.0 – Initial Release - Automatically saves chat messages to a SQLite database in real time - Supports searching by session and date - Tracks model usage statistics - Works as a background plugin; no manual activation needed - Configurable database path (default: ~/.openclaw/session-archive.db) via openclaw.json
Metadata
Slug session-archive
Version 0.4.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Session Archive?

Automatically saves conversation messages to a SQLite database with query and model usage statistics functionality. It is an AI Agent Skill for Claude Code / OpenClaw, with 233 downloads so far.

How do I install Session Archive?

Run "/install session-archive" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Session Archive free?

Yes, Session Archive is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Session Archive support?

Session Archive is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Session Archive?

It is built and maintained by 18940111404 (@18940111404); the current version is v0.4.1.

💬 Comments