Obsidian对话备份

技能简介

obsidian-conversation-backup 是一套纯 Shell 脚本实现的对话自动归档系统，将 Clawdbot 会话以聊天样式写入 Obsidian 笔记库。支持按小时增量捕获、彩色标注区分角色、多段落排版，防止因 /new 重置导致的历史记录丢失。

业务背景

防止关键业务对话数据意外丢失。Clawdbot 会话因 /new 指令重置后历史不可追溯，该方案通过定时增量捕获机制，将交流内容持续归档至 Obsidian，形成可检索的企业知识资产，同时监控 Token 消耗避免服务中断。

落地案例：客服团队每日处理大量客户咨询，重要解决方案散落在临时会话中。系统每小时自动检测新消息，按时段生成带角色区分的聊天快照，客服人员可随时在 Obsidian 中回溯特定时间段的完整上下文，一键导出典型会话作为培训案例，Token 接近上限时即时推送预警。

能做什么

• 每小时自动检测新消息，生成增量快照（无重复内容）
• 按整点时段拆分对话，便于快速定位特定时间段的交流
• 一键导出完整会话为独立 Markdown 文件
• 监控 Token 用量，接近上限时推送 Telegram 提醒
• 过滤空消息与系统通知，仅保留有效对话

使用说明

安装步骤

1. 解压技能包并进入目录：

   unzip obsidian-conversation-backup.skill
   cd obsidian-conversation-backup

2. 运行交互式安装器：

   chmod +x install.sh
   ./install.sh

   按提示填写 Obsidian 仓库路径、会话目录位置、跟踪文件存放位置。

3. 或手动配置：复制 config.example 为 config，编辑路径后执行 chmod +x scripts/*.sh

启用自动备份

crontab -e
# 添加以下行（每整点执行）
0 * * * * /path/to/obsidian-conversation-backup/scripts/monitor_and_save.sh

按需完整导出

scripts/save_full_snapshot.sh [主题名称]

按小时整理当日对话

scripts/create_hourly_snapshots.sh YYYY-MM-DD

自定义外观：编辑 scripts/format_message_v2.jq 可更换用户/助手表情符号及标注框类型。

输入与输出

见下方输入与输出表格。

风险提示

• 删除 .last_save_line_count、.last_snapshot_timestamp 等隐藏跟踪文件会导致增量备份重复捕获旧内容
• Token 预警仅在跨越阈值时触发一次，若未收到提醒不代表用量安全
• 依赖 cron 服务正常运行，需确认 crontab -l 中任务已生效
• 会话文件路径变更后需同步更新各脚本中的 SESSION_FILE 变量

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/laserducktales/obsidian-conversation-backup/SKILL.md
来源类型：GitHub 开源项目