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环境变量未设置时,自动检测功能失效