核心用法
Tide Watch 是一款专为 OpenClaw 设计的会话容量监控工具,通过双模式架构提供灵活的监控方案。
模式一:指令模式(推荐)
- 零代码安装,仅需将模板指令复制到
AGENTS.md和HEARTBEAT.md - 利用 OpenClaw 内置工具(
session_status)读取会话状态 - 每小时自动检测容量,按阈值(75%/85%/90%/95%)分级预警
模式二:CLI 工具模式(可选)
- 需 Node.js 14+,通过
npm link安装 - 提供
tide-watch status、dashboard、archive等命令 - 直接读写
~/.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需要审查代码,避免安装未验证版本