fix: openclaw binds embed versioning (#256)

* fix: openclaw binds embed versioning

* fix: openclaw binds embed versioning

Author: nicoloboschi

hindsight-docs/docs/sdks/integrations/openclaw.md

@@ -13,13 +13,13 @@ This plugin integrates [hindsight-embed](https://vectorize.io/hindsight/cli), a
 ```bash
 # 1. Configure your LLM provider
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 
 # 2. Install and enable the plugin
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 
 # 3. Start OpenClaw
-clawdbot gateway
+openclaw gateway
 ```
 
 That's it! The plugin will automatically start capturing and recalling memories.
@@ -118,7 +118,7 @@ Think of hooks as "forced automation" - they always run.
 ### Prerequisites
 
 - **Node.js** 22+
-- **OpenClaw** (Clawdbot) with plugin support
+- **OpenClaw** with plugin support
 - **uv/uvx** for running `hindsight-embed`
 - **LLM API key** (OpenAI, Anthropic, etc.)
 
@@ -127,21 +127,21 @@ Think of hooks as "forced automation" - they always run.
 ```bash
 # 1. Configure your LLM provider
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 
 # 2. Install and enable the plugin
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 
 # 3. Start OpenClaw
-clawdbot gateway
+openclaw gateway
 ```
 
 On first start, `uvx` will automatically download `hindsight-embed` (no manual installation needed).
 
 
 ## Configuration
 
-Optional settings in `~/.clawdbot/clawdbot.json`:
+Optional settings in `~/.openclaw/openclaw.json`:
 
 ```json
 {
@@ -178,14 +178,14 @@ The plugin auto-detects your configured provider and API key:
 Configure with:
 ```bash
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 ```
 
 ## Verification
 
 **Check if plugin is loaded:**
 ```bash
-clawdbot plugins list | grep hindsight
+openclaw plugins list | grep hindsight
 # Should show: ✓ enabled │ Hindsight Memory │ ...
 ```
 
@@ -262,10 +262,10 @@ uvx hindsight-embed@latest entity graph openclaw
 **Plugin not loading?**
 ```bash
 # Check plugin installation
-clawdbot plugins list | grep -i hindsight
+openclaw plugins list | grep -i hindsight
 
 # Reinstall if needed
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 ```
 
 **Daemon not starting?**
@@ -293,7 +293,7 @@ echo $OPENAI_API_KEY
 **Memories not being stored?**
 ```bash
 # Check gateway logs for auto-capture
-tail -f /tmp/clawdbot/clawdbot-*.log | grep Hindsight
+tail -f /tmp/openclaw/openclaw-*.log | grep Hindsight
 
 # Should see:
 # [Hindsight Hook] agent_end triggered

hindsight-docs/static/get-cli

@@ -3,6 +3,7 @@ set -e
 
 # Hindsight CLI installer
 # Usage: curl -fsSL https://hindsight.vectorize.io/get-cli | bash
+# Or with specific version: HINDSIGHT_CLI_VERSION=0.4.3 curl -fsSL https://hindsight.vectorize.io/get-cli | bash
 
 REPO_URL="https://github.com/vectorize-io/hindsight"
 INSTALL_DIR="${HINDSIGHT_INSTALL_DIR:-$HOME/.local/bin}"
@@ -169,9 +170,18 @@ main() {
     platform=$(detect_platform)
     print_info "Detected platform: $platform"
 
-    # Get latest version
-    version=$(get_latest_version)
-    print_info "Latest version: $version"
+    # Get version (from env var or latest)
+    if [[ -n "$HINDSIGHT_CLI_VERSION" ]]; then
+        version="$HINDSIGHT_CLI_VERSION"
+        # Add 'v' prefix if not present (GitHub releases use v-prefix)
+        if [[ ! "$version" =~ ^v ]]; then
+            version="v${version}"
+        fi
+        print_info "Using specified version: $version"
+    else
+        version=$(get_latest_version)
+        print_info "Latest version: $version"
+    fi
 
     # Download binary
     tmp_file=$(download_binary "$platform" "$version")

hindsight-docs/versioned_docs/version-0.4/sdks/integrations/openclaw.md

@@ -13,13 +13,13 @@ This plugin integrates [hindsight-embed](https://vectorize.io/hindsight/cli), a
 ```bash
 # 1. Configure your LLM provider
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 
 # 2. Install and enable the plugin
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 
 # 3. Start OpenClaw
-clawdbot gateway
+openclaw gateway
 ```
 
 That's it! The plugin will automatically start capturing and recalling memories.
@@ -127,21 +127,21 @@ Think of hooks as "forced automation" - they always run.
 ```bash
 # 1. Configure your LLM provider
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 
 # 2. Install and enable the plugin
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 
 # 3. Start OpenClaw
-clawdbot gateway
+openclaw gateway
 ```
 
 On first start, `uvx` will automatically download `hindsight-embed` (no manual installation needed).
 
 
 ## Configuration
 
-Optional settings in `~/.clawdbot/clawdbot.json`:
+Optional settings in `~/.openclaw/openclaw.json`:
 
 ```json
 {
@@ -178,14 +178,14 @@ The plugin auto-detects your configured provider and API key:
 Configure with:
 ```bash
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 ```
 
 ## Verification
 
 **Check if plugin is loaded:**
 ```bash
-clawdbot plugins list | grep hindsight
+openclaw plugins list | grep hindsight
 # Should show: ✓ enabled │ Hindsight Memory │ ...
 ```
 
@@ -262,10 +262,10 @@ uvx hindsight-embed@latest entity graph openclaw
 **Plugin not loading?**
 ```bash
 # Check plugin installation
-clawdbot plugins list | grep -i hindsight
+openclaw plugins list | grep -i hindsight
 
 # Reinstall if needed
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 ```
 
 **Daemon not starting?**
@@ -293,7 +293,7 @@ echo $OPENAI_API_KEY
 **Memories not being stored?**
 ```bash
 # Check gateway logs for auto-capture
-tail -f /tmp/clawdbot/clawdbot-*.log | grep Hindsight
+tail -f /tmp/openclaw/openclaw-*.log | grep Hindsight
 
 # Should see:
 # [Hindsight Hook] agent_end triggered

hindsight-embed/hindsight_embed/cli.py

@@ -16,6 +16,9 @@
     HINDSIGHT_EMBED_LLM_MODEL: Optional. LLM model (default: "gpt-4o-mini").
     HINDSIGHT_EMBED_BANK_ID: Optional. Memory bank ID (default: "default").
     HINDSIGHT_EMBED_DAEMON_IDLE_TIMEOUT: Optional. Seconds before daemon auto-exits when idle (default: 300).
+    HINDSIGHT_EMBED_API_VERSION: Optional. hindsight-api version to use (default: matches embed version).
+                                 Note: Only applies when starting daemon. To change version, stop daemon first.
+    HINDSIGHT_EMBED_CLI_VERSION: Optional. hindsight CLI version to install (default: {embed_version}).
 """
 
 import argparse

hindsight-embed/hindsight_embed/daemon_client.py

@@ -39,7 +39,10 @@ def _find_hindsight_api_command() -> list[str]:
         return ["uv", "run", "--project", str(dev_api_path), "hindsight-api"]
 
     # Fall back to uvx for installed version
-    return ["uvx", "hindsight-api"]
+    # Allow version override via environment variable (defaults to matching embed version)
+    from . import __version__
+    api_version = os.getenv("HINDSIGHT_EMBED_API_VERSION", __version__)
+    return ["uvx", f"hindsight-api@{api_version}"]
 
 
 def _is_daemon_running() -> bool:
@@ -220,15 +223,24 @@ def install_cli() -> bool:
     import subprocess
     import sys
 
-    print("Installing hindsight CLI...")
+    from . import __version__
+
+    # Determine CLI version (use env var or match embed version)
+    cli_version = os.getenv("HINDSIGHT_EMBED_CLI_VERSION", __version__)
+
+    print(f"Installing hindsight CLI (version {cli_version})...")
     print(f"  Installer URL: {CLI_INSTALLER_URL}")
 
     try:
-        # Download and run installer
+        # Download and run installer with version env var
+        env = os.environ.copy()
+        env["HINDSIGHT_CLI_VERSION"] = cli_version
+
         result = subprocess.run(
             ["bash", "-c", f"curl -fsSL {CLI_INSTALLER_URL} | bash"],
             capture_output=True,
             text=True,
+            env=env,
         )
 
         if result.returncode != 0:

hindsight-integrations/openclaw/README.md

@@ -7,13 +7,13 @@ Biomimetic long-term memory for [OpenClaw](https://openclaw.ai) using [Hindsight
 ```bash
 # 1. Configure your LLM provider
 export OPENAI_API_KEY="sk-your-key"
-clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
+openclaw config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
 
 # 2. Install and enable the plugin
-clawdbot plugins install @vectorize-io/hindsight-openclaw
+openclaw plugins install @vectorize-io/hindsight-openclaw
 
 # 3. Start OpenClaw
-clawdbot gateway
+openclaw gateway
 ```
 
 That's it! The plugin will automatically start capturing and recalling memories.

…tegrations/openclaw/clawdbot.plugin.json …tegrations/openclaw/openclaw.plugin.jsonhindsight-integrations/openclaw/clawdbot.plugin.json renamed to hindsight-integrations/openclaw/openclaw.plugin.json hindsight-integrations/openclaw/clawdbot.plugin.json renamed to hindsight-integrations/openclaw/openclaw.plugin.json

@@ -5,7 +5,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "clawdbot": {
+  "openclaw": {
     "extensions": [
       "./dist/index.js"
     ]
@@ -27,7 +27,7 @@
   },
   "files": [
     "dist",
-    "clawdbot.plugin.json",
+    "openclaw.plugin.json",
     "README.md"
   ],
   "scripts": {

hindsight-integrations/openclaw/package.json

@@ -25,7 +25,7 @@ export class HindsightEmbedManager {
   ) {
     this.port = 8889; // hindsight-embed uses fixed port 8889
     this.baseUrl = `http://127.0.0.1:8889`;
-    this.embedDir = join(homedir(), '.clawdbot', 'hindsight-embed');
+    this.embedDir = join(homedir(), '.openclaw', 'hindsight-embed');
     this.llmProvider = llmProvider;
     this.llmApiKey = llmApiKey;
     this.llmModel = llmModel;

hindsight-integrations/openclaw/src/embed-manager.ts

@@ -107,8 +107,8 @@ function detectLLMConfig(api: MoltbotPluginAPI): {
     `Please set one of these environment variables:\n${keyInstructions}\n\n` +
     `You can set them in your shell profile (~/.zshrc or ~/.bashrc):\n` +
     `  export ANTHROPIC_API_KEY="your-key-here"\n\n` +
-    `Or run Moltbot with the environment variable:\n` +
-    `  ANTHROPIC_API_KEY="your-key" clawdbot start\n\n` +
+    `Or run OpenClaw with the environment variable:\n` +
+    `  ANTHROPIC_API_KEY="your-key" openclaw gateway\n\n` +
     `Alternatively, configure ollama provider which doesn't require an API key.`
   );
 }
@@ -272,10 +272,10 @@ export default function (api: MoltbotPluginAPI) {
 
         console.log('[Hindsight] Auto-recall for prompt:', prompt.substring(0, 50));
 
-        // Recall relevant memories (up to 1024 tokens)
+        // Recall relevant memories (up to 512 tokens)
         const response = await client.recall({
           query: prompt,
-          max_tokens: 1024,
+          max_tokens: 512,
         });
 
         if (!response.results || response.results.length === 0) {
@@ -287,7 +287,10 @@ export default function (api: MoltbotPluginAPI) {
         const memoriesJson = JSON.stringify(response.results, null, 2);
 
         const contextMessage = `<hindsight_memories>
+Relevant memories from past conversations (score 1=highest, prioritize recent when conflicting):
 ${memoriesJson}
+
+User message: ${prompt}
 </hindsight_memories>`;
 
         console.log(`[Hindsight] Auto-recall: Injecting ${response.results.length} memories`);