Tide Watch

🌊 智能会话容量守护,防溢出丢工作

OpenClaw会话容量监控工具,通过多级阈值预警防止上下文窗口溢出丢失工作,支持自动备份与会话恢复。

收藏
2.6k
安装
1.2k
版本
1.3.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Tide Watch 是一款专为 OpenClaw 设计的会话容量监控工具,通过双模式架构提供灵活的监控方案。

模式一:指令模式(推荐)

  • 零代码安装,仅需将模板指令复制到 AGENTS.mdHEARTBEAT.md
  • 利用 OpenClaw 内置工具(session_status)读取会话状态
  • 每小时自动检测容量,按阈值(75%/85%/90%/95%)分级预警

模式二:CLI 工具模式(可选)

  • 需 Node.js 14+,通过 npm link 安装
  • 提供 tide-watch statusdashboardarchive 等命令
  • 直接读写 ~/.openclaw/agents/main/sessions/ 目录

显著优点

1. 预防性保护:在上下文窗口溢出前主动预警,避免会话锁死导致的工作丢失
2. 分级预警机制:四档阈值(🟡75% 🟠85% 🔴90% 🚨95%)匹配不同紧急程度

3. 自动备份恢复:支持在 90%/95% 阈值触发自动备份,保留7天并可恢复

4. 会话续接管理:生成 resumption prompts,重置后可快速恢复上下文

5. 零依赖设计:CLI 模式无运行时依赖,仅使用 Node.js 内置模块

6. 模型无关:兼容任何 LLM 提供商(Anthropic、OpenAI、DeepSeek 等)

潜在缺点与局限性

1. 安全事件历史:v1.0.0 存在 CVE-2026-001 高危漏洞(shell 注入,CVSS 7.8),虽已于 v1.0.1 修复,但需用户主动升级
2. CLI 模式风险:修改类操作(archive、edit resume-prompt)存在文件系统风险

3. 配置复杂度:高级功能(频道特定覆盖、压缩备份)需要手动编辑配置

4. 监控盲区:仅监控本地会话文件,不追踪模型端的实际 token 消耗差异

5. 依赖 OpenClaw:需宿主平台支持 session_status 工具

适合人群

  • 长期项目开发者:运行数小时以上的复杂编程任务
  • 多频道管理者:同时在 Discord、Telegram、webchat 维护多个对话
  • 高价值工作用户:无法承受会话中断导致的上下文丢失
  • 运维敏感型用户:需要自动化监控而非手动检查

常规风险

  • 误报/漏报风险:阈值基于文件统计,可能与实际模型上下文有偏差
  • 备份存储增长:高频会话可能产生大量备份文件(可配置压缩和保留期)
  • 恢复复杂性:会话恢复后需重新建立模型连接,非完全无缝
  • CLI 安装风险npm link 需要审查代码,避免安装未验证版本

Tide Watch 内容

bin文件夹
docs文件夹
examples文件夹
lib文件夹
tests文件夹
fixtures文件夹
session-resolution文件夹
integration文件夹
unit文件夹
手动下载zip · 117.4 kB
tide-watch.jstext/javascript
请选择文件