SQLite 笔记系统
数据库位置
~/.openclaw/workspace/notes/notes.db
初始化
首次使用时运行初始化脚本：
python3 ~/.agents/skills/notes-skill/scripts/init.py
该脚本会创建目录和表结构。
表结构
CREATE TABLE notes (
id INTEGER PRIMARY KEY AUTOINCREMENT,
content TEXT NOT NULL,
archived INTEGER DEFAULT 0,
created_at DATETIME DEFAULT (datetime('now', 'localtime'))
);
CREATE INDEX idx_notes_created ON notes(created_at DESC);
CREATE INDEX idx_notes_archived ON notes(archived);
写入笔记前的处理
收到笔记内容后，先优化再写入：
- 结构优化：适当分段、补充标点、整理格式，使笔记更易读
- 错别字处理：修正明显的拼写错误，保持原意不变
- 不损失内容：不删减、不曲解原文，只优化表达方式
示例：
- 用户输入：
今天学到了git clone 问题 报错 could not read Username
- 优化后：
今天学到了 GitHub clone 的问题：报错 "could not read Username"。原因是非 TTY 环境下 git 的凭证读取机制有问题...
SQL 示例
添加笔记
收到笔记内容后，先优化再写入（见上方处理规则）。优化完成后写入：
INSERT INTO notes (content) VALUES ('优化后的笔记内容');
搜索（LIKE 模糊搜索）
SELECT * FROM notes WHERE content LIKE '%关键词%';
列出全部（按时间倒序）
SELECT * FROM notes ORDER BY created_at DESC;
筛选未归档
SELECT * FROM notes WHERE archived = 0;
标记已归档
UPDATE notes SET archived = 1 WHERE id = 3;
查看单条
SELECT * FROM notes WHERE id = 1;
定时备份任务
每天凌晨 2 点自动备份（通过 OpenClaw cron 触发）。
Agent 收到 backup_notes 事件时，执行：
python3 ~/.agents/skills/notes-skill/scripts/backup.py 3
手动备份
运行备份脚本：
python3 ~/.agents/skills/notes-skill/scripts/backup.py [保留份数]
- 不传参数：默认保留 7 份
- 传参数：如
python3 backup.py 10 保留 10 份
备份文件保存在 ~/.openclaw/workspace/notes/backups/。
