中文介绍更新： 🧠 Redis Memory System — 跨 Session 短期记忆，开箱即用 一行命令安装，自动读写 Redis，无需手动配置。让 OpenClaw Agent 跨 session 记得你是谁。 安装： chmod +x scripts/setup.sh && bash scripts/setup.sh 安装后自动： 📖 Session 启动时自动读取 — 通过 .bootstrap 机制加载近期记忆 ✍️ 每小时 cron 保底写入 — 即使会话意外中断也不丢数据 🧹 对话结束时自动摘要写入 — 三层保障，零维护 特性： 🔹 7 天 TTL，自动过期不撑磁盘 🔹 多账号隔离，双脚本设计 🔹 参数强校验，健壮可靠 🔹 独立于 Session 生命周期 English Description Update: 🧠 Redis Memory System — Zero-config cross-session memory for OpenClaw agents. One command to install, zero manual config. Your agent automatically remembers conversations across session resets. Install: chmod +x scripts/setup.sh && bash scripts/setup.sh After install, everything runs automatically: 📖 Auto-read at session start — Bootstrap loads Redis context before the first reply ✍️ Hourly cron backup — Independent timestamp writes, survives crashes 🧹 Auto-summary on conversation end — Three-layer protection, zero maintenance Features: 🔹 7-day auto-expiring TTL, no disk bloat 🔹 Multi-user isolation with dual scripts 🔹 Strict parameter validation 🔹 Independent of OpenClaw session lifecycle

中文介绍： 🧠 Redis Memory System — 跨 Session 短期记忆，给 Agent 装上"短期记忆海马体" OpenClaw Agent 每次会话被回收后（04:00框架重置 / 120分钟空闲 / 24小时平台超时），都会像失忆一样醒来。这套系统在会话之外增加了一层 Redis 存储，让 Agent 醒来第一时间知道你昨天聊了什么。 工作原理 每次对话结束时，Agent 自动将当日对话摘要写入 Redis Hash，KEY 级 TTL 设为 7 天。下次 Session 启动时，SOUL.md 铁律强制先查 Redis 再回话——从"我是谁"到"我们聊到哪了"，全程衔接。 核心特性 🔹 跨 session 记忆保持 — 不依赖框架层的上下文持久化，独立于 Session 生命周期 🔹 多账号数据隔离 — 同一进程服务多位用户时，memory:账号A 和 memory:账号B 是独立的 Hash key，双脚本+SOUL 铁律双重保障 🔹 Heartbeat 自动续写保底 — 即使对话意外中断（断网/崩溃/超时），下一次 Heartbeat Poll 会自动检查并写入摘要，零数据丢失 🔹 7 天 TTL 自动过期 — 短期记忆就该自动遗忘。不撑磁盘、不需维护、不留隐私隐患 🔹 双脚本设计 — 通用版 redismemory.sh 适合单用户/互信多用户场景；隔离版 redismemoryisolated.sh 通过 REDISMEMORY_USER 环境变量硬编码用户身份，防止跨账号误操作 🔹 参数强校验 — set -euo pipefail 保障脚本健壮性，日期格式与有效性双重校验（YYYY-MM-DD + date -d 验证），缺参友好提示 🔹 操作审计 — 独立的 actions:system Hash 记录下载文件、安装软件等后台操作，解决"谁干的"溯源问题 🔹 轻量极致 — 每条记忆仅 0.5~2KB，代理端无需额外依赖，只需 Redis-server 运行在 localhost:6379 与官方 MEMORY.md 的区别 官方 OpenClaw 提供文件式 MEMORY.md（长期）和 memory_search（语义检索），但依赖会话上下文写入。这套系统在文件层之外增加了一层 Redis——7天窗口内的记忆自动存活，不需要手动提炼。两套互补：Redis 管"短期不忘"，MEMORY.md 管"长期不朽"。 English Description: 🧠 Redis Memory System — Cross-session short-term memory for OpenClaw agents. Think of it as a hippocampus for your AI. OpenClaw agents lose session context at predictable boundaries: daily framework reset (04:00), idle timeout (120 min), and platform-level disconnection (24h). Without external memory, every new session starts from scratch — the agent has no idea what you talked about yesterday. This system bridges that gap with a lightweight Redis layer that preserves daily conversation summaries across session boundaries. How it works When a conversation ends, the agent automatically writes a daily summary to a Redis Hash keyed by user and date (memory:<user> → YYYY-MM-DD). Each key has a 7-day TTL. On every new session start, SOUL.md iron rules force the agent to query Redis before responding to the user — transforming "Who am I talking to?" into "We were discussing X yesterday, let's pick up from there." Key Features 🔹 Cross-session persistence — Survives framework resets, idle timeouts, and platform disconnections. Independent of OpenClaw's session lifecycle 🔹 Multi-user isolation — memory:userA and memory:userB are separate Redis Hash keys within the same instance. Dual-script architecture + SOUL.md behavioral rules create defense in depth against data leakage 🔹 Heartbeat auto-save fallback — If a conversation cuts off unexpectedly (network drop, crash, timeout), the next Heartbeat poll automatically checks for unsaved context and writes it. Zero data loss by design 🔹 7-day TTL auto-expire — Short-term memory should forget by default. No disk bloat, no manual cleanup, no privacy residue 🔹 Dual scripts — redis_memory.sh (general purpose) for single-user or trusted multi-user scenarios; redis_memory_isolated.sh (sandboxed) enforces a fixed username via REDIS_MEMORY_USER environment variable, preventing accidental cross-user writes 🔹 Strict validation — set -euo pipefail for script-level robustness; dual-layer date validation (regex format check + date -d existence check); friendly error messages for missing arguments 🔹 Action audit trail — A separate actions:system Hash records system operations (file downloads, software installs), answering "Who did what and when?" 🔹 Extremely lightweight — ~0.5–2KB per memory entry. No agent-side dependencies beyond a running Redis-server on localhost:6379 vs. OpenClaw's built-in MEMORY.md OpenClaw's official memory system uses file-based MEMORY.md (long-term) and semantic search (memory_search/memory_get), but relies on in-session context for writes. This skill adds a Redis layer beneath it — day-level summaries survive automatically within the 7-day window without manual curation. The two complement each other: Redis handles "don't forget what we just talked about," MEMORY.md handles "remember this forever."

## 1.0.0 - 2026-05-17 ### Added - Redis-backed cross-session memory for OpenClaw agents - 7-day TTL auto-expiry for all memory keys - Multi-user memory isolation on single Redis instance - Heartbeat-based auto-saving (prevents memory loss on interruptions) - System operation audit log (actions:system) - Two scripts: `redis_memory.sh` (multi‑user) and `redis_memory_isolated.sh` (fully isolated) ## 1.0.0 - 2026-05-17 ### 新增 - 为 OpenClaw 智能体提供基于 Redis 的跨会话记忆 - 所有记忆键支持 7 天 TTL 自动过期 - 单 Redis 实例实现多用户记忆隔离 - 基于心跳的自动保存（防止因中断丢失近期记忆） - 系统操作审计日志（actions:system） - 提供两个脚本：`redis_memory.sh`（多用户版）和 `redis_memory_isolated.sh`（完全隔离版）