Why HindClaw?

Built on Hindsight — the highest-scoring agent memory system on the LongMemEval benchmark.

The official Hindsight plugin gives you auto-capture and auto-recall. HindClaw adds what you need to run it in production:

• Per-user access control — Confluence-style permissions. Groups, roles, bank-level overrides. CEO gets full recall; staff gets filtered views.
• Cross-agent recall — Yoda reads from R4-P17's financial memories and BB-8's operational notes. One query, multiple banks.
• Named retain strategies — "deep-analysis" for strategy topics, "lightweight" for daily chat. Routed by conversation topic.
• Infrastructure as code — hindclaw plan shows what will change. hindclaw apply syncs it. Like Terraform for memory banks.

Quick Start

1. Install

openclaw plugins install hindclaw

2. Configure

Add to your openclaw.json (or a $include'd config file):

{
  "plugins": {
    "entries": {
      "hindclaw": {
        "enabled": true,
        "config": {
          "dynamicBankGranularity": ["agent"],
          "bootstrap": true
        }
      }
    }
  }
}

3. Start

openclaw gateway

That's it — memories are captured and recalled automatically. The plugin starts a local Hindsight daemon on first run (requires Python 3.11+ and uv).

For bank configs, access control, strategies, and multi-server setups, see the full documentation.

Features

Bank Management

Define agent memory banks as JSON5 files — missions, entity labels, directives, dispositions. All version-controlled.

hindclaw plan --all     # preview changes
hindclaw apply --all    # sync to Hindsight
hindclaw import --agent yoda --output ./banks/yoda.json5

See CLI Reference.

Access Control

Users, groups, and bank-level permission overrides. Tag-based recall filtering with Hindsight's tag_groups API (AND/OR/NOT boolean logic).

// groups/executive.json5
{
  "displayName": "Executive",
  "members": ["ruben"],
  "recall": true,
  "retain": true,
  "recallBudget": "high",
  "recallTagGroups": null  // no filter — sees everything
}

See Access Control.

Named Strategies

Route different conversation topics to different extraction strategies:

// In bank config
{
  "retain": {
    "strategies": {
      "deep-analysis": { "topics": ["280304"] },
      "lightweight":   { "topics": ["280418"] }
    }
  }
}

See Bank Configuration.

Cross-Agent Recall

An agent can recall from multiple banks. Permissions are checked per-bank — no unauthorized cross-reads.

{
  "recallFrom": ["yoda", "r4p17", "bb9e"],
  "recallBudget": "high"
}

See Configuration.

Documentation

| Guide | Description | |-------|-------------| | Configuration | Plugin config, behavioral defaults, per-agent overrides | | Bank Configuration | Missions, entity labels, strategies, $include directives | | Access Control | Users, groups, permissions, resolution algorithm | | CLI Reference | hindclaw plan, apply, import, init | | Development | Building, testing, contributing |

Migration from @vectorize-io/hindsight-openclaw

openclaw plugins remove @vectorize-io/hindsight-openclaw
openclaw plugins install hindclaw

Bank ID scheme is compatible — existing memories are preserved. bankMission becomes retain_mission in bank config files. All other plugin-level options use the same names.

Links

• Hindsight — the memory engine
• OpenClaw — the agent framework
• GitHub

License

MIT — see LICENSE

Based on @vectorize-io/hindsight-openclaw (MIT, Copyright (c) 2025 Vectorize AI, Inc.)