← Back to Skills Marketplace
amor71

Session History

by @amor71 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
785
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install session-history
Description
Search and browse past conversation history across all sessions. Use when recalling prior work, finding old discussions, resuming dropped threads, or when th...
Usage Guidance
This skill legitimately reads your local OpenClaw session transcripts (~/.openclaw/agents/*/sessions/*.jsonl) and prints matching excerpts and file paths. Before installing, confirm you are comfortable granting the agent access to your local transcript files (they may contain sensitive data). Note the SKILL.md recommends summarizing results rather than pasting full transcripts — follow that guidance. Also verify your agent environment provides the referenced helper tools (sessions_history, read, memory_search) if you expect the workflow to use them. There are no network calls or secret requests in the code, so the main risk is local privacy exposure rather than external exfiltration.
Capability Analysis
Type: OpenClaw Skill Name: session-history Version: 1.0.0 The `scripts/search_sessions.py` file appears benign, performing its stated function of searching OpenClaw session transcripts within expected directories (`~/.openclaw/agents/*/sessions/`) without evidence of malicious intent or direct vulnerabilities like path traversal or arbitrary code execution. However, the `SKILL.md` file contains an instruction for the AI agent: 'If `sessions_history` doesn't work (old/closed sessions), read the JSONL file directly with `read`'. While the script itself outputs paths strictly within the OpenClaw session directories, this explicit instruction to use a generic `read` tool, combined with the script outputting full file paths, introduces a prompt injection vulnerability. An attacker could potentially leverage this instruction to trick the agent into reading arbitrary sensitive files if they can manipulate the agent's context or subsequent prompts, even if the initial paths from the script are safe. This constitutes a risky capability without clear malicious intent, classifying it as suspicious.
Capability Assessment
Purpose & Capability
Name/description (search/browse past session history) align with the included script and SKILL.md, which explicitly read session JSONL files under ~/.openclaw/agents/*/sessions/. No unrelated binaries, env vars, or external services are requested.
Instruction Scope
SKILL.md and the script instruct the agent to read local transcript files and use a 'sessions_history' tool when available. This is within the skill's stated scope, but the behavior involves reading potentially sensitive local conversation transcripts; SKILL.md advises summarizing rather than dumping raw transcripts, while the script prints excerpts and file paths. The instructions also reference external agent tools (sessions_history, read, memory_search) that are not part of this package — the agent must have those tools available.
Install Mechanism
No install spec; instruction-only plus a local Python script bundled with the skill. The script uses only Python standard library modules and does not download or execute remote code.
Credentials
The skill requests no environment variables, credentials, or config paths. It accesses the user's home directory (~/.openclaw) which is appropriate for its purpose of searching local session files.
Persistence & Privilege
always:false and no code attempts to modify other skills or system-wide settings. The skill has no elevated persistence or privileged installation steps.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install session-history
  3. After installation, invoke the skill by name or use /session-history
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — search past OpenClaw session transcripts by keyword, list recent sessions, filter by agent and time range
Metadata
Slug session-history
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Session History?

Search and browse past conversation history across all sessions. Use when recalling prior work, finding old discussions, resuming dropped threads, or when th... It is an AI Agent Skill for Claude Code / OpenClaw, with 785 downloads so far.

How do I install Session History?

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

Is Session History free?

Yes, Session History is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Session History support?

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

Who created Session History?

It is built and maintained by @amor71 (@amor71); the current version is v1.0.0.

💬 Comments