核心用法
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 可能遗漏关键上下文,需人工复核