Redis Cache

使用说明

Redis Cache Skill 提供 Redis 全数据结构操作能力，覆盖字符串、哈希、列表、集合、有序集合，以及发布订阅、流水线和事务支持。是构建缓存层、分布式锁和消息队列的基础工具。

clawhub install redis-cache

核心功能

• 字符串操作：GET/SET/MGET/MSET，支持过期和原子操作（INCR/DECR）
• 哈希操作：HSET/HGET/HMGET/HGETALL，适合存对象
• 列表操作：LPUSH/RPUSH/LPOP/RPOP/LRANGE，实现队列和栈
• 集合操作：SADD/SMEMBERS/SISMEMBER，标签和去重
• 有序集合：ZADD/ZRANGE/ZSCORE，排行榜和优先级队列
• 过期策略：EXPIRE/TTL/PERSIST，灵活控制数据生命周期

配置

export REDIS_HOST=localhost
export REDIS_PORT=6379
export REDIS_PASSWORD=your-password
export REDIS_DB=0

使用示例

把用户 123 的会话信息缓存到 Redis，过期时间 30 分钟

获取排行榜前 10 名

发布消息到 channel:alerts

典型场景

• API 响应缓存，降低数据库压力
• 分布式锁，防止并发冲突
• 实时排行榜
• 消息队列（发布/订阅）
• 限流计数器

注意事项

1. 生产环境务必设置密码
2. 大 key（>10KB）建议拆分
3. 合理设置过期时间，避免内存泄漏
4. 监控内存使用，设置 maxmemory 策略