hotcore

Redis-backed hierarchical entity storage for OpenClaw. Provides structured, queryable persistent storage with automatic attribute indexing — complementing OpenClaw's text-based memory system.

Features

• Hierarchical entities — parent-child tree structure with traversal
• Automatic attribute indexing — all entity attributes indexed for fast search
• Wildcard search — glob patterns (*, ?, [abc]) with multi-criteria AND
• Optimistic locking — safe concurrent updates via Redis WATCH/MULTI/EXEC
• Cross-platform — pure TypeScript, runs on Windows/macOS/Linux

Install

openclaw plugins install hotcore

Configure

Add to ~/.openclaw/config.json:

{
  "plugins": {
    "entries": {
      "hotcore": {
        "enabled": true,
        "config": {
          "host": "localhost",
          "port": 6379
        }
      }
    }
  }
}

Configuration options

| Option | Type | Default | Description | |--------|------|---------|-------------| | host | string | required | Redis server hostname | | port | number | 6379 | Redis server port | | db | number | 0 | Redis database number | | password | string | — | Redis password | | tls | boolean | false | Enable TLS/SSL | | nonIndexableFields | string[] | see below | Fields stored but not indexed |

Default non-indexable fields: status_history, station_data, connector_data, raw_data, metadata, logs, events.

Tools

Once installed, the agent has access to these tools:

| Tool | Description | |------|-------------| | storage_create | Create an entity under a parent with attributes | | storage_get | Retrieve an entity by UUID | | storage_update | Update entity attributes (set to null to remove) | | storage_delete | Delete an entity | | storage_find | Search by attribute filters with wildcard support | | storage_children | List direct children of an entity | | storage_parent | Get the parent of an entity |

Example agent interactions

Agent: I'll store this project configuration.
→ storage_create { parent_uuid: "root", attributes: { type: "project", name: "Hotcore", status: "active" } }

Agent: Let me find all active projects.
→ storage_find { criteria: { type: "project", status: "active" } }

Agent: Let me find all entities with names starting with "Hot".
→ storage_find { criteria: { name: "Hot*" } }

Prerequisites

A running Redis (or ValKey) instance. Quick start:

docker run -d --name redis -p 6379:6379 redis:alpine

Standalone usage

The core client can be used without OpenClaw:

import { HotcoreClient } from "hotcore/src/client.js";

const client = new HotcoreClient({ host: "localhost" });

const entity = client.init({ type: "user", name: "Alice", role: "admin" });
await client.create("root", entity);

const users = await client.find({ type: "user", role: "admin" });

Development

npm install
npm test           # run unit tests (ioredis-mock, no Redis needed)
npm run test:watch # watch mode
npm run build      # compile TypeScript

Related

• hotcore — the original Python implementation

License

Apache 2.0