核心用法
Redis Memory System 是为 OpenClaw Agent 设计的跨会话短期记忆解决方案，基于 Redis 实现零配置开箱即用。用户只需执行 setup.sh 即可完成 Redis 安装、系统 cron 注册及脚本部署，无需手动维护复杂配置。
系统采用三层铁壁写入架构：对话中通过 draft 命令写入 12 小时 TTL 的临时摘要；系统级 cron 每小时自动升级为永久存储；OpenClaw Cron 和 Heartbeat 每 2 小时提供兜底保障。最终数据以 memory:<用户>:YYYY-MM-DD 格式存储，7 天自动过期。
对话触发时机包括话题结束、用户告别、长会话（>30分钟）、空闲超时（>90分钟）及重要事件发生时。Agent 调用 redis_memory.sh draft <用户> "<摘要>" 即可写入。
多账号场景使用 redis_memory_isolated.sh，通过 REDIS_MEMORY_USER 环境变量强制隔离，防止数据串读。
显著优点
1. 一键部署：单命令完成 Redis 安装、cron 注册、脚本拷贝
2. 多层兜底：draft→cron→OpenClaw Cron→Heartbeat 四层保障写入
3. 自动过期：7 天 TTL 避免数据堆积，无需手动清理
4. 多用户隔离：隔离版脚本通过环境变量实现严格的账号边界
5. 零配置运行：安装后仅需两步手动配置即可投产
潜在缺点
1. 明文存储：Redis 数据未加密，明确禁止存储密码密钥
2. 单点依赖：Redis 服务故障将导致记忆功能中断
3. TTL 限制：7 天过期无法支持长期历史回溯
4. Linux 限定：依赖 apt/cronie，Windows/macOS 需额外适配
5. 权限要求：需 root 权限安装 Redis 和系统 cron
适合人群
- 需要 Agent 具备跨会话短期记忆能力的 OpenClaw 用户
- 多账号/多租户场景下需严格数据隔离的运营者
- 不愿投入复杂配置、追求开箱即用的效率型用户
- 能接受 7 天记忆周期的轻量级记忆需求场景
常规风险
- 数据泄露风险：Redis 默认仅本机访问，但明文存储敏感信息仍可能导致泄露
- 权限管理风险：多账号场景若混用通用版/隔离版脚本，可能导致数据串读
- 服务可用性：Redis 进程异常将导致记忆读写失败，建议配置监控
- cron 依赖风险：系统 cron 或 OpenClaw 服务异常可能影响持久化时机