核心用法
snail-mail 是一款为 AI 助手设计的"慢通道"收件箱系统,解决"何时打扰人类操作员"的经典难题。它通过 Node.js 脚本提供完整的 CLI 工作流:用 add 写入带优先级标记的消息([URGENT]/[IMPORTANT] 前缀或默认 normal),用 list 按状态筛选,用 read/archive 管理生命周期,最后用 render 根据 OPENCLAW_CHANNEL 自动输出 HTML/Markdown/纯文本格式。
显著优点
1. 智能降噪设计:明确的写入准则(需要决策/异常/有趣/FYI)与排除规则(例行成功、重复信息),避免信息过载
2. 多通道自适应渲染:通过环境变量自动识别 Telegram、Discord、Slack、WebChat 等平台,输出最优格式
3. 原子化存储安全:单写者模型 + 临时文件重命名策略,杜绝 JSON 数据库损坏
4. 心跳集成:支持在定期自检中自动上浮紧急事项,实现"静默守护→主动提醒"的分层交互
潜在局限
- 单节点架构:无内置同步机制,多实例同时写入可能冲突(尽管文档声称"无需锁")
- Node.js 依赖:环境要求限制轻量化部署场景
- 无持久化备份:
messages.json为单一文件,误删或磁盘故障无恢复机制 - 人机协同门槛:操作员需理解"慢通道"哲学,否则可能沦为第二个被忽略的收件箱
适合人群
高频人机协作场景(自动化运维、内容运营、社区管理)中,需要建立"AI 初筛→人类决策"工作流的技术团队。特别适合已有 Node 环境、使用 Telegram/Discord 等现代通讯工具的用户。
常规风险
- 优先级误标:AI 可能过度使用
[URGENT]导致操作员脱敏("狼来了"效应) - 存储路径暴露:
OPENCLAW_WORKSPACE若指向敏感目录,JSON 文件可能被其他进程读取 - 长期堆积:无自动过期策略,归档前的消息可能无限增长影响性能