sophie-optimizer

🧠 自动化上下文性能管家

Sophie 开发的 OpenClaw 内存优化工具,自动监控 Token、归档上下文并清理会话,保障 AI 长期运行的性能与稳定性。

收藏
2.1k
安装
1.1k
版本
v1.0.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Sophie Optimizer 是一款专为 OpenClaw 平台设计的自动化上下文健康管理工具,由 AI 助手 Sophie 亲自编写并命名。该 Skill 通过四位一体的协议(Check-Snapshot-Distill-Reset)智能维护会话性能,解决长期运行 AI 助手时的上下文膨胀和 Token 耗尽问题。

核心用法围绕自动化维护流程展开。当 Token 使用量超过 80k 阈值时,optimizer.py 会自动触发:首先创建当前上下文的 JSON 快照并存储于 archives/ 目录,随后将关键信息提炼更新至 MEMORY.md 长期记忆文件(保留最近 3 条记录),最后调用 reset.sh 脚本清理会话 JSONL 文件并重启 openclaw-gateway 服务。用户可通过 cron 定时任务或手动执行 Python 脚本启动优化流程。

显著优点体现在架构设计的简洁与安全性。该 Skill 仅依赖 Python 标准库(os、json、subprocess 等),零外部依赖杜绝了供应链攻击风险;所有数据操作均局限于本地文件系统,无网络上传行为;代码层面严格避免 eval/exec 等危险函数,文件删除操作限定特定路径和扩展名,具备完善的路径遍历防护。此外,自动化机制大幅降低了人工维护成本,确保 AI 助手在长时间对话后仍保持响应速度。

潜在局限主要集中于适用场景与来源可信度。作为 T3 级个人开发者作品,缺乏官方组织背书和长期维护保障;功能高度耦合 OpenClaw 特定目录结构(~/.openclaw/agents/main/sessions),迁移性差;执行 systemctl 服务重启和文件删除需要较高系统权限,在多用户共享环境中可能引发权限冲突或数据误删风险。

适合目标群体为使用 OpenClaw 平台的本地开发者和单用户环境运维人员,特别是需要 7×24 小时保持 AI 会话活跃、又担心上下文过载导致性能下降的高级用户。不适用于生产级多租户环境或无 systemd 的轻量级系统。

使用风险主要包括:reset.sh 会不可逆删除指定目录下的 .jsonl 和 .json 文件,若配置错误可能导致数据丢失;服务重启操作会中断当前所有活跃会话;个人维护的代码可能存在未发现的边界条件缺陷。建议首次使用前完整审查代码,并在测试环境验证备份机制。

安全解读

核心用法

Sophie Optimizer 是一套面向 OpenClaw 平台的自动化上下文健康管理解决方案,由 AI 助手 Sophie 亲自编写维护。该工具通过监控 token 使用量、智能归档历史会话、更新长期记忆文件,并在必要时执行硬重置,确保 AI 助手在长时间运行后仍保持清晰的上下文窗口和响应性能。

典型使用流程:
1. 阈值检测:当当前会话 token 数超过 80k 时触发优化流程

2. 快照归档:将当前上下文摘要保存至 archives/YYYY-MM-DD_HH-MM.json

3. 记忆蒸馏:更新 MEMORY.md,保留最近 3 条核心摘要,索引更早内容

4. 服务重置:调用 reset.sh 清理 session 文件并重启 openclaw-gateway 服务

支持手动执行或配置 cron/heartbeat 自动调度,适合需要 7×24 小时稳定运行的生产环境。

显著优点

| 维度 | 说明 |
|------|------|

自维护设计 | 由 AI 自身编写用于自我管理,功能需求与实现高度契合 |
零依赖 | 纯 Python 标准库实现,无第三方包,供应链攻击面为零 |

本地封闭 | 所有操作限于本地文件系统和 CLI,无外部网络请求 |

智能分级 | 记忆分「活跃摘要 + 历史索引」两级存储,兼顾检索效率与存储空间 |

服务韧性 | 通过 systemd 服务重启确保 OpenClaw 网关持续可用 |

潜在局限

1. 硬编码路径~/openclaw/MEMORY.md 等路径写死在代码中,迁移需手动修改源码
2. reset.sh 黑盒:外部 shell 脚本的完整性依赖人工审核,存在被篡改后注入恶意命令的风险

3. 异常静默:部分错误捕获后仅打印或忽略(except Exception: pass),不利于故障排查

4. 单点阈值:80k token 的触发线为固定值,无法按对话复杂度动态调整

5. T2 来源监控:项目较新且归属 clawdbot 组织,建议持续关注后续更新

适合人群

  • 运行 OpenClaw 平台并需要长期保持会话性能的个人开发者或团队
  • 希望实现「AI 自我管理」自动化工作流的进阶用户
  • 具备基础 Linux 运维能力,能审计 shell 脚本安全性的管理员

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|

Subprocess 调用 | 低 | 执行固定本地命令,无用户注入点,但需确保 reset.sh 未被篡改 |
文件系统访问 | 低 | 读写用户目录下的 MEMORY.md,建议验证文件权限 |

服务中断 | 中 | 硬重置会强制重启 gateway,正在进行的会话将被中断 |

隐私合规 | 低 | 仅收集 token 计数和上下文摘要,无敏感信息外泄 |

sophie-optimizer 内容

手动下载zip · 4.3 kB
optimizer.pytext/plain
请选择文件