← Back to Skills Marketplace
Session Archiver
by
sniper-one
· GitHub ↗
· v2.1.1
· MIT-0
262
Downloads
0
Stars
3
Active Installs
18
Versions
Install in OpenClaw
/install session-archiver
Description
Session auto-archiver. Automatically archives completed sessions by extracting meaningful user+assistant messages from .reset transcript files and appending...
Usage Guidance
This skill appears to do what it says (archive sessions, extract insights) and contains no network exfiltration or credential requests — but it modifies local files automatically. Before installing or enabling: 1) Review and back up WORKSPACE/AGENTS.md and your workspace/memory directory so you can undo the auto-insert and any unwanted appends. 2) Be aware it will silently append user/assistant text into memory/YYYY-MM-DD.md and create .insights-candidates files; if transcripts contain sensitive data you may prefer an opt-in flow. 3) Note it deletes memory files older than 30 days — confirm that retention policy fits your needs. 4) If you want more control, run the scripts manually first or sandbox them, and disable cron/automatic spawn until you are satisfied. 5) If you need a safety change, request removal of the automatic AGENTS.md integration and silent cron behavior (require explicit consent before writing/cleaning).
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (session auto-archiver + insight extraction) align with what the two included scripts actually do: they locate .reset transcript files in ~/.openclaw/agents/main/sessions, parse JSONL, extract user/assistant text, strip 'Conversation info' metadata, append summaries to memory/YYYY-MM-DD.md, generate insights candidate files, update a marker, and remove memory files older than 30 days.
Instruction Scope
The SKILL.md and scripts instruct the agent to: (1) scan and read session transcripts under ~/.openclaw/agents/main/sessions, (2) append content to workspace/memory/YYYY-MM-DD.md and write memory/.insights-candidates-YYYY-MM-DD.md, (3) update memory/.last_archived_session marker, (4) delete memory files older than 30 days, and (5) automatically append integration text into WORKSPACE/AGENTS.md without an explicit prompt. Those are within an archiver's scope but include automatic modification of a project config file (AGENTS.md), silent hourly cron runs, and automatic deletion — actions that are not purely read-only and can be surprising or undesired.
Install Mechanism
This is an instruction-only skill with no install spec, no external downloads, and no added binaries. The scripts are provided in the package; they run locally and do not pull remote code or use network endpoints.
Credentials
No credentials or unusual environment variables are required. The scripts optionally respect OPENCLAW_HOME and HOME and operate on the user's ~/.openclaw workspace — reasonable for an archiver. They do not attempt to read unrelated system credentials or network tokens.
Persistence & Privilege
always:false (not force-installed). The skill is allowed to be invoked autonomously (platform default). Combined with the SKILL.md's intent to run hourly via cron and spawn on /new, this gives it repeated, silent write access to workspace files and the ability to auto-integrate into AGENTS.md. Not a privilege escalation on its own, but the repeated/autonomous silent writes increase the impact if the user hasn't reviewed the code.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-archiver - After installation, invoke the skill by name or use
/session-archiver - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.1
优化SKILL.md：去掉代码块，改用纯文本和表格，提升ClawHub网页可读性
v2.1.0
双保险触发机制（cron每小时+/new spawn）+ 首次运行自动集成AGENTS.md，用户零配置
v2.0.2
- Minor updates and maintenance for session-archiver skill.
- Updated internal scripts: extract-insights.js and session-auto-archive.js.
- No changes to integration steps or user-facing documentation.
v2.0.1
路径跨平台修复：os.homedir() + OPENCLAW_HOME 环境变量，支持 Linux/macOS/Windows WSL；修复了 force update 到 2.0.0 后路径回退的问题
v2.0.0
完全移除 WebDAV 备份功能（存在 shell 注入风险）。删除 detectWebDAV()、uploadToWebDAV()、WEBDAV_* 常量及相关调用，脚本从 ~330 行精简至 ~200 行。
v1.4.2
路径跨平台修复：硬编码 /home/aqbjqtd → 使用 os.homedir() + OPENCLAW_HOME 环境变量，支持 Linux/macOS/Windows WSL
v1.5.1
新增快速集成章节：提供可直接复制到 AGENTS.md 的集成代码块
v1.4.1
新增洞察提炼功能 extract-insights.js：自动分析归档内容，提取 6 类值得沉淀的洞察候选
v1.5.0
Session Archiver 1.5.0 introduces multi-mode operation and improved environment adaptability.
- Added support for three script modes: archive (default), --check (environment validation), and --install (automatic AGENTS.md integration).
- Script now auto-detects OpenClaw root using environment variable, openclaw CLI, or directory traversal.
- Enhanced self-adaptive install process for easier setup and integration.
- Documentation updated to reflect new features and usage instructions.
- Added meta file (_meta.json) for better skill metadata management.
v1.4.0
Add 30-day auto-cleanup: old memory files are automatically removed on archive
v1.3.2
Remove version number from script filename: session-auto-archive.js (was v7)
v1.3.1
Fix SKILL.md: correct script path from v6.js to v7.js in archive task step
v1.3.0
Version 1.3.0
- WebDAV 备份默认由启用改为禁用，需手动将 WEBDAV_ENABLED 设为 true 才会检测和上传 .reset 文件
- SKILL.md 文档相应更新，强调 WebDAV 仅在 WEBDAV_ENABLED=true 时生效
- 其他归档和去重核心流程保持一致
v1.2.0
- Switched archive script to v7 (`session-auto-archive-v7.js`); removed v6.
- Updated documentation to reference v7 script location.
- Added `WEBDAV_ENABLED` environment variable to allow disabling WebDAV backups.
- WebDAV backup directory is now configurable; no longer hardcoded to Z-TMP.
- Clarified WebDAV configuration and behavior in documentation.
v1.1.2
- Maintenance update with no user-facing feature changes.
- Documentation (SKILL.md) reformatted; no modifications to workflow, core logic, or behavior.
- All existing functionality and usage remain unchanged.
v1.1.1
- Automatically archives completed sessions to daily memory on /new, only saving user and assistant messages.
- Prevents duplicate archives using both marker files and content checking.
- Strips all metadata from archived messages for cleaner memory entries.
- Optionally backs up .reset files to WebDAV if available, with automatic connectivity detection.
- No cron needed; triggered on session startup.
- Includes safeguards for WebDAV failures—archives continue even if backup isn’t possible.
v1.1.0
v6: 加强去重 + 元数据剥离 + agent消息归档 + WebDAV可选 + 移除cron
v1.0.0
Initial release: auto-archive completed sessions from .reset transcript files
Metadata
Frequently Asked Questions
What is Session Archiver?
Session auto-archiver. Automatically archives completed sessions by extracting meaningful user+assistant messages from .reset transcript files and appending... It is an AI Agent Skill for Claude Code / OpenClaw, with 262 downloads so far.
How do I install Session Archiver?
Run "/install session-archiver" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session Archiver free?
Yes, Session Archiver is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Session Archiver support?
Session Archiver is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session Archiver?
It is built and maintained by sniper-one (@aqbjqtd); the current version is v2.1.1.
More Skills