A robust shell-based utility for automatically backing up and formatting Clawdbot AI conversations directly into your Obsidian vault using beautiful chat-style Markdown.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-conversation-backup
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 obsidian-conversation-backup 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 Obsidian Conversation Backup?
The Obsidian Conversation Backup skill is a dedicated utility designed to bridge the gap between transient AI agent sessions and permanent knowledge storage. By utilizing Openclaw Skills, developers can ensure their research and coding dialogues are never lost to session resets or context clearing. This tool specifically targets power users who rely on Obsidian for their PKM workflow, providing a high-fidelity archival system that requires zero additional token costs.
This skill transforms raw JSONL session data into aesthetically pleasing Markdown callouts, complete with timestamps and custom emojis. It operates as a local background process, ensuring your data stays private and your Obsidian vault remains the single source of truth for all your AI-generated insights and project decisions.
Obsidian Conversation Backup Use Cases
- Preventing data loss during frequent session resets or /new resets in your development environment.
- Archiving long-running research sessions for long-term project documentation and retrieval.
- Monitoring token usage in real-time to avoid hitting context limits during critical coding tasks.
- Organizing chaotic daily AI interactions into clean, hourly structured documents for end-of-day reviews.
How Obsidian Conversation Backup Works
- The system monitors local session files generated by your AI agent at a specified directory path.
- A cron job triggers the backup script at defined intervals, typically every hour at the top of the hour.
- The script identifies new message lines added since the last successful snapshot using hidden tracking files.
- Message content is processed via jq to apply Obsidian-specific callout formatting, timestamps, and multi-paragraph support.
- The formatted Markdown is appended to the specified directory within your Obsidian vault.
- Token thresholds are checked during the process, sending automated alerts if usage exceeds safe limits.
Obsidian Conversation Backup Setup
To begin using this tool with your Openclaw Skills, follow these installation steps:
# Extract the skill files
unzip obsidian-conversation-backup.skill
cd obsidian-conversation-backup
# Run the interactive installer to configure paths
chmod +x install.sh
./install.sh
# Enable automatic hourly backups via crontab
crontab -e
# Add the following line to the file:
0 * * * * /path/to/obsidian-conversation-backup/scripts/monitor_and_save.sh
Obsidian Conversation Backup Data Schema & Taxonomy
The skill organizes data into Markdown files with a specific naming convention to ensure easy navigation within Obsidian:
| File Type | Naming Convention | Description |
|---|---|---|
| Incremental Snapshot | YYYY-MM-DD-HHmm-incremental.md |
Contains new messages captured during the specific hourly window. |
| Full Snapshot | [topic-name].md |
A complete, on-demand dump of the entire current session context. |
| Hourly Breakdown | YYYY-MM-DD-HH00-hourly.md |
Reorganized logs grouped by clock hour for daily archival logic. |
| Tracking Files | .last_snapshot_timestamp |
Internal state files used to prevent duplicate data entry. |
Obsidian Conversation Backup Advanced Features
- Custom callout styling for User and Assistant roles using Obsidian-native CSS-compatible syntax.
- Integrated notification system for high-priority token limit warnings via Telegram hooks.
- Flexible scheduling allowing for backup frequencies ranging from minutes to daily intervals via cron.
- Intelligent filtering logic that automatically excludes system notifications and empty message blocks.
- Multi-agent support by adjusting the configuration to point to different session file locations.
SKILL.md
Loading
Related Openclaw Skills
Lottery Analyzer
A sophisticated data analysis tool for identifying patterns and generating optimized number recommendations for SSQ and DLT lotteries.
Obsidian Tasks
A comprehensive task management framework for Obsidian vaults that integrates Kanban boards, Dataview dashboards, and structured YAML metadata.
Obsidian Task Management
A comprehensive task management framework for Obsidian vaults featuring Kanban boards, Dataview dashboards, and YAML-driven task notes.
Agent Content Pipeline
A human-in-the-loop content automation workflow for AI agents to draft, revise, and stage social media posts securely.
Video Download FaaS
An asynchronous background video downloader that utilizes yt-dlp and FaaS isolation to deliver standardized MP4 files.
Radon AI
A specialized MCP server that provides AI agents with deep visibility into React Native environments, including logs, network traffic, and real-time documentation.
Featured*
