History

Anton Evseev c461013047 fix(openclaw): shell safety, HTTP dual-mode, lazy reinit, per-user banks (#388 ) - exec→execFile: bypass shell entirely, preventing injection via special characters in chat history - HTTP dual-mode: client can now talk directly to the Hindsight API via HTTP (setBankMission, retain, recall) when apiUrl is configured, bypassing the subprocess/CLI entirely for production deployments - HindsightClientOptions: replace 5 positional constructor args with a typed options object for clarity and extensibility - sanitize(): strip null bytes from strings — Node 22 rejects them in execFile() args - recall timeout: accept optional timeoutMs parameter for both HTTP and subprocess modes; subprocess gets a longer 30s default - In-flight recall dedup: concurrent recalls for the same bank reuse one promise instead of firing duplicate requests - Timeout/abort handling: graceful warn-level logging instead of error spam when recall times out - Error cause chaining: wrap errors with { cause } for better debugging stack traces - lazyReinit: recover from startup health check failure with 30s cooldown and concurrency guard - Per-user banks: derive bank ID from senderId (not channelId) for proper memory isolation per user across channels - buildClientOptions(): centralized helper replaces 7 duplicated constructor call sites Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>		2026-02-18 13:09:02 +01:00
..
src	fix(openclaw): shell safety, HTTP dual-mode, lazy reinit, per-user banks (#388 )	2026-02-18 13:09:02 +01:00
.gitignore	fix: rename openclawd to openclaw (#252 )	2026-01-30 13:04:42 +01:00
install.sh	fix: openclaw improve config setup (#258 )	2026-01-30 17:36:49 +01:00
openclaw.plugin.json	fix(openclaw): shell safety, HTTP dual-mode, lazy reinit, per-user banks (#388 )	2026-02-18 13:09:02 +01:00
package-lock.json	fix(openclaw): avoid memory retain recursion (#362 )	2026-02-13 10:47:39 +01:00
package.json	Release v0.4.11	2026-02-13 10:52:14 +01:00
README.md	feat: improve openclaw and hindisght-embed params (#279 )	2026-02-03 09:39:04 +01:00
tsconfig.json	fix: rename openclawd to openclaw (#252 )	2026-01-30 13:04:42 +01:00
vitest.config.ts	fix: rename openclawd to openclaw (#252 )	2026-01-30 13:04:42 +01:00

README.md

Hindsight Memory Plugin for OpenClaw

Biomimetic long-term memory for OpenClaw using Hindsight. Automatically captures conversations and intelligently recalls relevant context.

Quick Start

# 1. Configure your LLM provider for memory extraction
# Option A: OpenAI
export OPENAI_API_KEY="sk-your-key"

# Option B: Claude Code (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code

# Option C: OpenAI Codex (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex

# 2. Install and enable the plugin
openclaw plugins install @vectorize-io/hindsight-openclaw

# 3. Start OpenClaw
openclaw gateway

That's it! The plugin will automatically start capturing and recalling memories.

Documentation

For full documentation, configuration options, troubleshooting, and development guide, see:

OpenClaw Integration Documentation

Development

To test local changes to the Hindsight package before publishing:

Add embedPackagePath to your plugin config in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "hindsight-openclaw": {
        "enabled": true,
        "config": {
          "embedPackagePath": "/path/to/hindsight-wt3/hindsight-embed"
        }
      }
    }
  }
}

The plugin will use uv run --directory <path> hindsight-embed instead of uvx hindsight-embed@latest
To use a specific profile for testing:

# Check daemon status
uvx hindsight-embed@latest -p openclaw daemon status

# View logs
tail -f ~/.hindsight/profiles/openclaw.log

# List profiles
uvx hindsight-embed@latest profile list

License

MIT