Token Saver v3

💡 你知道吗？每次 API 调用都会发送您的工作区文件（SOUL.md、USER.md、MEMORY.md、AGENTS.md 等）以及您的消息。这些文件会占用您的上下文窗口，拖慢响应速度，并且每条消息都会产生实际费用。

Token Saver v3 是模型感知型——它了解您模型的上下文窗口并据此调整推荐方案。使用 Gemini 的 1M 上下文？预设方案会相应扩大。使用 GPT-4o 的 128K？预设方案会相应调低。

v3 版本新功能

命令

功能

📊 模型感知仪表盘

显示当前模型、上下文窗口及使用百分比：

🤖 Model: Claude Opus 4.5 (200K context)
   Detected: openclaw.json

📊 Context Usage: [████████░░░░░░░░░░░░] 42% (84K/200K)

📁 工作区文件压缩

扫描所有.md文件，显示令牌计数与潜在节省空间。智能跳过功能可绕过已优化文件。

文件感知压缩：

• SOUL.md—— 轻度压缩，保留个性语言
• AGENTS.md—— 中度压缩，密集指令处理
• USER.md / MEMORY.md—— 重度压缩，采用键值对格式
• PROJECTS.md—— 无压缩（保持用户原有结构）

💬 动态压缩预设

预设方案将适配您的模型上下文窗口：

🤖 模型注册表

24+ 个模型，包含上下文窗口、定价和别名：

• Claude：Opus 4.6 (1M), Opus 4.5, Sonnet 4.5, Sonnet 4, Haiku 4.5, Haiku 3.5 (200K)
• OpenAI：GPT-5.2, GPT-5.1, GPT-5-mini, GPT-5-nano (256K), GPT-4.1, GPT-4o (128K), o1, o3, o4-mini
• Gemini：3 Pro (2M), 2.5 Pro, 2.0 Flash (1M)
• 其他：DeepSeek V3 (64K), Kimi K2.5 (128K), Llama 3.3 70B, Mistral Large

🔍 稳健的模型检测

检测优先级：

1. 运行时注入 (--model=...)
2. 环境变量 (SKILL_MODEL,OPENCLAW_MODEL)
3. 配置文件 (~/.openclaw/openclaw.json)
4. 文件推断（TOOLS.md、MEMORY.md 提及）
5. 后备方案：Claude Sonnet 4（安全默认值）

未知模型处理：

• 严格版本匹配 —opus-6.5不会模糊匹配到opus-4.5
• 未知模型采用安全默认设置（20万上下文长度）并附带警告
• 易于添加新模型至scripts/models.json

📝 持久化模式

为AGENTS.md添加持续优化的写作指引：

安全性

• 自动备份— 所有修改文件均获得.backup扩展名
• 完整性优先于体积— 绝不为了减少token数量而牺牲语义
• 智能绕过机制—— 跳过已优化的文件
• 随时还原——/optimize revert恢复所有内容
• 无需外部调用—— 所有分析均在本地运行

安装

clawhub install token-saver --registry "https://www.clawhub.ai"

版本历史

• 3.0.0—— 模型注册、动态预设、稳健检测、智能绕过
• 2.0.1—— 聊天压缩、文件感知压缩、持久模式
• 1.0.0—— 初始版本