Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Automatic conversation backup system for Obsidian with incremental snapshots, hourly breakdowns, and formatted chat-style markdown. Use when setting up conversation archival, preventing data loss from /new resets, or organizing chat history in Obsidian vault with proper formatting (colored callouts, timestamps, multi-paragraph support).
Automatic conversation backup system for Obsidian with incremental snapshots, hourly breakdowns, and formatted chat-style markdown. Use when setting up conversation archival, preventing data loss from /new resets, or organizing chat history in Obsidian vault with proper formatting (colored callouts, timestamps, multi-paragraph support).
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Automatically backs up Clawdbot conversations to Obsidian with beautiful chat-style formatting. Prevents data loss from /new resets with hourly incremental snapshots.
Incremental backups: Hourly snapshots of new messages only (no duplication) Chat formatting: Obsidian callouts with emojis, timestamps, proper multi-paragraph support Hourly breakdowns: Organize conversations by clock hour for easy reference Zero token cost: Pure shell scripting, no LLM calls Smart filtering: Skips empty messages and system notifications
# Extract the skill (if downloaded as .skill file) unzip obsidian-conversation-backup.skill cd obsidian-conversation-backup # Run installer (interactive) chmod +x install.sh ./install.sh The installer will ask for: Obsidian vault path Session directory location Tracking files location Or manual setup: Copy config.example to config Edit config with your paths Make scripts executable: chmod +x scripts/*.sh
Add to crontab for hourly backups: crontab -e # Add this line (runs every hour at :00) 0 * * * * /path/to/obsidian-conversation-backup/scripts/monitor_and_save.sh
Edit scripts/format_message_v2.jq to change: User emoji (default: ๐) Assistant emoji (default: ๐ฆ) Callout types (default: [!quote] for user, [!check] for assistant)
Once configured in cron, the system runs automatically: Every hour: Checks for new messages (โฅ10 lines) Creates incremental snapshot if found Saves to: YYYY-MM-DD-HHmm-incremental.md Skips if no new conversation Example output: 2026-01-20-1500-incremental.md (messages from last save to now) 2026-01-20-1600-incremental.md (new messages since 15:00) 2026-01-20-1700-incremental.md (new messages since 16:00) Protection: Max conversation loss = 1 hour
Save complete conversation anytime: scripts/save_full_snapshot.sh [topic-name] Examples: scripts/save_full_snapshot.sh important-decisions scripts/save_full_snapshot.sh bug-fix-discussion scripts/save_full_snapshot.sh # uses "full-conversation" as default
Create organized breakdown by clock hour: scripts/create_hourly_snapshots.sh YYYY-MM-DD Example: scripts/create_hourly_snapshots.sh 2026-01-20 Output: 2026-01-20-1500-hourly.md (15:00-15:59 messages) 2026-01-20-1600-hourly.md (16:00-16:59 messages) 2026-01-20-1700-hourly.md (17:00-17:59 messages) Use case: End-of-day organization for easy reference
Messages appear as colored Obsidian callouts: User messages (blue [!quote] callout): > [!quote] ๐ User ยท 15:30 > This is my message Assistant messages (green [!check] callout): > [!check] ๐ฆ Zoidbot ยท 15:31 > This is the response Features: Timestamps (HH:MM format) Multi-paragraph support (uses <br><br> for paragraph breaks) Proper line wrapping (all lines prefixed with > ) Empty messages filtered out System notifications excluded
The monitor_and_save.sh script also tracks token usage: Warnings via Telegram: 800k tokens (80%): "Consider /new soon" 900k tokens (90%): "Run /new NOW" Implementation: # Sends warning only when crossing threshold (one-time) # No repeated warnings # Resets when back under 800k
scripts/ โโโ monitor_and_save.sh # Hourly incremental backup + token monitoring โโโ save_full_snapshot.sh # On-demand full conversation save โโโ create_hourly_snapshots.sh # Organize by clock hour โโโ format_message_v2.jq # Chat formatting logic
The system uses hidden files to track state: /root/clawd/.last_save_line_count # For token monitoring /root/clawd/.last_snapshot_timestamp # For incremental saves /root/clawd/.token_warning_sent # For warning deduplication Note: Do not delete these files or incremental backups may duplicate content
Default: /root/.clawdbot/agents/main/sessions/*.jsonl If your session files are elsewhere, update the SESSION_FILE path in each script.
Check cron is running: crontab -l Verify script has execute permission: chmod +x scripts/*.sh Check logs: Run manually to see errors
Ensure format_message_v2.jq has the gsub("\n\n"; "<br><br>") line Check that all lines have > prefix Verify jq is installed: jq --version
Delete tracking files and let system reset: rm /root/clawd/.last_snapshot_timestamp
Update format_message_v2.jq to filter empty messages Check for the if ($text_content | length) > 0 condition
jq: JSON parsing (apt-get install jq) cron: For automatic backups Obsidian vault: Target directory for markdown files
Edit crontab: # Every 2 hours 0 */2 * * * /path/to/monitor_and_save.sh # Every 30 minutes */30 * * * * /path/to/monitor_and_save.sh # Specific times only (9am, 12pm, 6pm, 9pm) 0 9,12,18,21 * * * /path/to/monitor_and_save.sh
Edit monitor_and_save.sh: # Change from 10 to 5 messages minimum if [[ $new_lines -lt 5 ]]; then
Obsidian callout types: [!quote] - Blue [!check] - Green [!note] - Cyan [!tip] - Purple [!warning] - Orange [!danger] - Red
Edit monitor_and_save.sh to change warning text or add custom notifications.
Run hourly breakdown at end of day - Use as organizational tool, not backup Keep incremental backups running - This is your safety net Test scripts after setup - Run manually first to verify output Backup tracking files - Include .last_snapshot_timestamp in vault backups Use descriptive topic names - For full snapshots, use meaningful names
Daily routine: Automatic incremental backups run hourly (no action needed) At end of day: scripts/create_hourly_snapshots.sh 2026-01-20 Review organized hourly files in Obsidian Delete old incrementals if desired (hourly breakdown covers them) Before /new reset: Optional: scripts/save_full_snapshot.sh before-reset Run /new safely - conversation is backed up Continue chatting - incrementals resume automatically
This skill works with: HEARTBEAT.md: Automatic token monitoring MEMORY.md: Conversation archival system Telegram integration: Warning notifications Any Obsidian vault: Works with existing vaults
Created by the Clawdbot community for reliable conversation backup and beautiful Obsidian formatting.
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.