Tide Watch

🌊 智能会话守护,告别上下文溢出

OpenClaw 会话容量监控工具,提供 75%-95% 四级阈值预警,自动备份会话防止上下文窗口溢出丢失工作,支持无代码指令模式与可选 CLI 工具双模式运行。

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

使用说明

Tide Watch 核心功能

Tide Watch 是一款专为 OpenClaw 设计的会话容量监控与管理工具,旨在解决 AI 对话中上下文窗口无声溢出的痛点——当会话达到 100% 容量时会完全锁定,导致工作丢失。

核心用法

双模式架构:

  • Directives-Only 模式(推荐):零代码安装,仅通过 AGENTS.md 和 HEARTBEAT.md 模板配置,利用 OpenClaw 原生工具实现被动监控
  • CLI Tools 模式(可选):Node.js 命令行工具,提供主动管理能力

四级预警机制:

  • 🟡 75% — 提示关注,建议适时收尾
  • 🟠 85% — 建议完成当前任务并准备重置
  • 🔴 90% — 会话即将锁定,准备重置
  • 🚨 95% — 关键警报,立即保存至记忆

自动保护机制:

  • 阈值触发时自动备份会话文件
  • 生成会话恢复提示词(resumption prompts)
  • 支持跨会话仪表盘、归档管理、历史追踪

显著优点

1. 零依赖安全设计:Directives-Only 模式无需 Node.js、npm 或任何代码安装,攻击面最小
2. 模型无关:支持 Anthropic、OpenAI、DeepSeek 等任意提供商

3. 非侵入式:静默监控,仅在阈值触发时提醒,不干扰 workflow

4. 高度可配置:阈值百分比、检查频率(5分钟-6小时)、备份策略、通道特定覆盖均可自定义

5. 状态追踪:记录已警告的阈值,避免重复打扰;会话重置后自动清零

6. 多代理支持:适用于多代理(multi-agent)复杂部署场景

潜在局限与风险

架构局限:

  • CLI 模式需 Node.js 14+,对纯前端环境不友好
  • 文件操作局限于本地 OpenClaw 会话目录,无网络同步能力
  • 依赖 OpenClaw 的 session_status 工具,其他平台不可用

安全风险(已修复):

  • CVE-2026-001:v1.0.0 版本的 editResumePrompt 函数存在 shell 注入漏洞(CVSS 7.8),v1.0.1 已修复
  • CLI 模式下需验证版本号,避免使用 v1.0.0

操作风险:

  • 归档操作(tide-watch archive)会移动会话文件,误操作可能导致数据位置变更
  • 恢复提示词编辑功能需谨慎处理外部输入

适合人群

  • 长期项目开发者:需要持续数小时/数天的复杂任务会话管理
  • 多通道用户:同时在 Discord、Telegram、网页端等多个对话通道工作的用户
  • 高价值工作场景:无法承受会话锁定导致上下文丢失的关键业务场景
  • 多代理部署管理员:需要跨代理监控会话容量的运维人员

常规风险

  • 误报/漏报:阈值设置过于激进或保守都可能影响使用体验
  • 存储占用:自动备份若开启压缩不当,可能积累大量归档文件
  • 恢复复杂性:会话恢复后需手动重新建立部分上下文连接
  • 环境依赖OPENCLAW_SESSION_ID 环境变量未设置时,自动检测功能失效

Tide Watch 内容

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