@lacneu/hindsight-openclaw

Fork of @vectorize-io/hindsight-openclaw with a single behavioral change: deriveBankId resolves the canonical user identity from sessionKey when OpenClaw's session.identityLinks is configured.

Why this fork

OpenClaw supports session.identityLinks to unify sessions across channels for the same human user:

{
  "session": {
    "dmScope": "per-channel-peer",
    "identityLinks": {
      "alice": ["telegram:123", "discord:987"]
    }
  }
}

Upstream @vectorize-io/hindsight-openclaw does not honor this mapping when computing bank IDs — it reads senderId (the raw channel peer) instead of the canonical identity resolved into sessionKey. Result: Alice writing from Telegram and Discord ends up with two separate Hindsight banks, breaking cross-channel memory consolidation.

This fork extracts the canonical identity from the sessionKey's direct:<canonical> segment and uses it as the user field in dynamicBankGranularity. One human = one bank, regardless of channel.

See upstream issues that motivated this fork:

• openclaw/openclaw#67735 — WebChat does not honor identityLinks
• openclaw/openclaw#46652 — Matrix identityLinks broken
• openclaw/openclaw#52504 — Cross-Platform Session Continuity feature request

Installation

openclaw plugins install @lacneu/hindsight-openclaw

The plugin is a drop-in replacement — it keeps the same id: "hindsight-openclaw" so existing configs and slot assignments (plugins.slots.memory: "hindsight-openclaw") continue to work.

Configuration (typical)

{
  "session": {
    "dmScope": "per-channel-peer",
    "identityLinks": {
      "olivier": ["telegram:12345", "openwebui:[email protected]"]
    }
  },
  "plugins": {
    "entries": {
      "hindsight-openclaw": {
        "enabled": true,
        "config": {
          "bankIdPrefix": "olivier",
          "dynamicBankGranularity": ["agent", "user"],
          "hindsightApiUrl": "http://hindsight:8888"
        }
      }
    }
  }
}

With dynamicBankGranularity: ["agent", "user"] and identityLinks configured, all channels linked to olivier feed the same Hindsight bank.

Backwards compatibility

The patch is purely additive. When session.identityLinks is not configured or the sessionKey doesn't contain a direct:<canonical> segment, the plugin falls back to the raw senderId — behavior is identical to upstream.

Relation to upstream

Based on @vectorize-io/hindsight-openclaw 0.6.5. Starting with 0.7.0 this fork follows an independent semver track (0.7.x, 0.8.x, …); earlier releases used the now-retired <upstream>-identity.<n> scheme, which npm/OpenClaw treated as prereleases and required explicit version pinning at install time.

License

MIT — inherited from upstream Hindsight.