Tide Watch

🌊 智能会话容量预警,守护长时任务不中断

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

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

使用说明

核心用法

Tide Watch 是为 OpenClaw 设计的会话容量监控与管理工具,提供两种运行模式:

指令模式(推荐):零代码安装,通过 AGENTS.md 和 HEARTBEAT.md 模板实现自动监控,依赖 OpenClaw 原生工具(session_status)检测容量,无需 Node.js 或外部依赖。

CLI 工具模式(可选):Node.js 14+ 环境下运行 tide-watch 命令,提供 status、dashboard、archive、resume-prompt 等子命令,支持手动管理、批量归档和实时监控。

关键功能

  • 四级阈值预警:75%(提醒)、85%(建议收尾)、90%(即将锁定)、95%(紧急保存)
  • 自动备份:在 90%/95% 阈值自动创建会话备份,支持压缩与保留策略
  • 会话恢复:生成并管理恢复提示词(resumption prompts),重置后快速重建上下文
  • 多代理支持:支持多代理环境下的会话隔离与过滤
  • 零运行时依赖:CLI 模式仅使用 Node.js 内置模块,无外部 npm 包

显著优点

1. 双模式安全设计:指令模式完全无代码执行风险,CLI 模式可选且源码透明
2. 模型无关:支持 Anthropic、OpenAI、DeepSeek 等任意提供商

3. 非侵入式:静默监控,仅达阈值时主动提醒

4. 状态追踪:记录已警告阈值,避免重复打扰

5. 灵活配置:阈值、频率、备份策略均可自定义,支持频道级覆盖

潜在缺点与局限性

  • CLI 历史漏洞:v1.0.0 存在 shell 注入漏洞(CVE-2026-001,CVSS 7.8),v1.0.1 已修复,需确保版本
  • CLI 需 Node.js:Windows 用户需额外安装 Node.js 14+
  • 文件系统权限:CLI 模式需读写 ~/.openclaw/agents/main/sessions/,可能受沙箱限制
  • 恢复非自动:会话重置后需手动触发恢复流程,非无缝衔接
  • 无网络通知:不支持邮件/Slack 等外部告警,仅限本地输出

适合人群

  • 长时任务开发者:持续数小时的代码生成、文档编写、复杂调试
  • 多频道运营者:同时管理 Discord、Telegram、Webchat 等多渠道对话
  • 高频 OpenClaw 用户:日均会话数高、容量焦虑严重的重度用户
  • 保守型用户:担心意外丢失上下文,需要主动预警机制

常规风险

  • 备份覆盖:高频备份可能占用磁盘空间,需配置保留策略
  • CLI 输入验证:尽管 CVE 已修复,仍建议仅使用 UUID 作为 session ID,避免特殊字符
  • 误报阈值:模型 token 计算方式差异可能导致实际可用容量与显示不符
  • 恢复提示质量:自动生成的 resumption prompt 可能遗漏关键上下文,需人工复核

Tide Watch 内容

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