name: agent-sleep description: Agent 睡眠系統 - 記憶整合、日誌歸檔、工作區清理（支援 CortexGraph） metadata: openclaw: emoji: "🛌" category: "system" tags: ["memory", "sleep", "consolidation", "cortexgraph"] schedulable: true

Agent Sleep System 🛌

像人類一樣，Agent 需要"睡眠"（離線維護）來防止記憶碎片化和上下文汙染。

功能

1. Micro-Rest - 快速上下文修剪
2. Deep Sleep - 每日日誌整合到長期記憶
3. CortexGraph 同步 - 同步到 CortexGraph（帶遺忘曲線）
4. Dreaming - 後臺模擬（可選）

工具

來源於7w4.net。

sleep_status

檢查 agent 是否"累了"（基於執行時間或 token 使用）

python3 scripts/sleep_status.py

run_sleep_cycle

觸發睡眠週期 - Light: 壓縮最近日誌 - Deep: 歸檔 + 檔案清理 - CortexGraph: 同步到 CortexGraph

python3 scripts/run_sleep_cycle.py --mode [light|deep|cortexgraph]

schedule

設定生物鐘（cron jobs）

python3 scripts/schedule.py --set "0 3 * * *"  # 3 AM 睡眠

工作流程

Deep Sleep 模式

1. 觸發 → Cron 在 3:00 AM 啟動
2. 讀取 → memory/YYYY-MM-DD.md（昨天日誌）
3. 提取 → 高價值洞察
4. 追加 → 到 MEMORY.md
5. 歸檔 → 原始日誌到 memory/archive/
6. 清理 → 刪除臨時檔案

CortexGraph 模式

1. 讀取 → MEMORY.md + daily logs
2. 同步 → 到 CortexGraph
3. 應用 → 遺忘曲線（自動衰減）
4. 晉升 → 高價值記憶到 LTM

遺忘曲線

CortexGraph 使用 Ebbinghaus 遺忘曲線：

score = (use_count)^β × e^(-λ × Δt) × strength

• β = 0.6（使用頻率權重）
• λ = ln(2) / half_life（預設 3 天）
• strength = 1.0-2.0（重要性）

使用

手動觸發

# 輕量睡眠
python3 scripts/run_sleep_cycle.py --mode light

# 深度睡眠
python3 scripts/run_sleep_cycle.py --mode deep

# CortexGraph 同步
python3 scripts/run_sleep_cycle.py --mode cortexgraph

定時設定

# 每天凌晨 3 點深度睡眠
python3 scripts/schedule.py --set "0 3 * * *"

# 每 6 小時 CortexGraph 同步
python3 scripts/schedule.py --set "0 */6 * * *"

目錄結構

agent-sleep/
├── SKILL.md
├── AGENT.md
├── scripts/
│   ├── run_sleep_cycle.py
│   ├── sleep_status.py
│   └── schedule.py
└── memory/
    ├── archive/        # 歸檔的日誌
    └── consolidated/   # 整合的記憶

配置

環境變數

# CortexGraph 配置
export CORTEXGRAPH_STORAGE_PATH=~/.config/cortexgraph/jsonl
export CORTEXGRAPH_DECAY_MODEL=power_law
export CORTEXGRAPH_PL_HALFLIFE_DAYS=3.0

ClawHub 配置

clawhub install agent-sleep

最佳實踐

1. 每日 Deep Sleep - 凌晨 3 點
2. 每 6 小時 CortexGraph 同步 - 保持記憶新鮮
3. 每週 GC - 清理低分記憶
4. 每月晉升 - 高價值記憶升級到 LTM

與其他 Skill 整合

版本: 1.1.0 更新: 新增 CortexGraph 支援

這個 Skill 概念新穎，文件描述的功能也很誘人（記憶整合、上下文清理），但實際程式碼基本不可用——核心功能都沒實現，只有一些模擬演示。對於普通使用者來說，這個 Skill 目前還不值得安裝使用，存在較大的使用風險，建議等待開發者完善後再嘗試。