OpenClaw Plugin

Persistent cloud memory for OpenClaw agents — survives context compaction.

Table of contents
  1. How it works
  2. Requirements
  3. Installation
    1. Step 1 — Install the plugin
    2. Step 2 — Configure credentials
    3. Step 3 — Enable auto-recall and auto-capture (optional, paid tiers)
    4. Step 4 — Restart the gateway
    5. Step 5 — Verify
  4. Full configuration reference
  5. Available tools
  6. File sync
  7. Tiers
  8. Troubleshooting
  9. Source & community

The HippoDid OpenClaw Plugin gives your OpenClaw agent persistent cloud memory that survives context compaction — without any MCP server or Java runtime required.

Unlike the MCP Setup approach, the plugin installs directly into OpenClaw’s plugin system and works automatically in the background.

How it works

  • auto-recall — before each agent response, relevant memories are pulled from HippoDid cloud and injected as context automatically
  • auto-capture — after each agent response, the conversation turn is saved to HippoDid cloud automatically
  • File sync — watched files (e.g. memory/YYYY-MM-DD.md) are synced to cloud on a configurable interval and flushed before compaction
  • Explicit tools — hippodid:remember, hippodid:recall, hippodid:sync, hippodid:status are available for direct agent use

Requirements

  • OpenClaw 2026.3.13 or later
  • A HippoDid API key (hd_sk_...) from the dashboard
  • A HippoDid character ID (create one in the dashboard)
  • Node.js 22+ (already required by OpenClaw)

Installation

Step 1 — Install the plugin 

openclaw plugins install @hippodid/openclaw-plugin

Step 2 — Configure credentials 

openclaw config set plugins.entries.hippodid-openclaw-plugin.config.apiKey "hd_sk_YOUR_KEY_HERE"
openclaw config set plugins.entries.hippodid-openclaw-plugin.config.characterId "YOUR_CHARACTER_ID"

Replace hd_sk_YOUR_KEY_HERE with your API key from the dashboard. Replace YOUR_CHARACTER_ID with your character UUID.

Step 3 — Enable auto-recall and auto-capture (optional, paid tiers) 

openclaw config set plugins.entries.hippodid-openclaw-plugin.config.autoRecall true
openclaw config set plugins.entries.hippodid-openclaw-plugin.config.autoCapture true

Step 4 — Restart the gateway 

openclaw gateway restart

Step 5 — Verify

Check the gateway logs for:

HippoDid loaded — character: <your-character-id>
hippodid: auto-recall hook registered (before_agent_start)
hippodid: auto-capture hook registered (agent_end)
hippodid: v1.x.x | tier: STARTER | autoRecall: ON | autoCapture: ON

Full configuration reference

All config keys live under plugins.entries.hippodid-openclaw-plugin.config in your ~/.openclaw/openclaw.json.

Key Required Default Description
apiKey Yes — Your HippoDid API key (hd_sk_...)
characterId Yes — Target character UUID
autoRecall — false Inject memories before each agent response (Starter+)
autoCapture — false Save conversation turns automatically (Starter+)
syncIntervalSeconds — 300 File sync polling interval in seconds
additionalPaths — [] Extra file paths to watch beyond the OpenClaw workspace
baseUrl — https://api.hippodid.com API base URL (leave as default)

Available tools

Once the plugin is loaded, your agent has access to these tools:

Tool Description
hippodid:remember Save information to HippoDid cloud memory
hippodid:recall Search HippoDid cloud memory
hippodid:sync Force-sync all watched files to cloud immediately
hippodid:status Show connection status, tier, and watched paths
hippodid:import Import existing workspace memory files into HippoDid

Example usage in chat:

use hippodid:remember to save: I prefer dark roast coffee
use hippodid:recall to search for: coffee preferences
use hippodid:status

File sync

The plugin automatically watches your OpenClaw workspace memory directory (memory/YYYY-MM-DD.md daily log files) and syncs them to cloud.

Compaction safety: Before OpenClaw compacts the context, the plugin triggers an immediate flush of all watched files — ensuring nothing is lost.

To add extra files beyond the workspace:

openclaw config set plugins.entries.hippodid-openclaw-plugin.config.additionalPaths \
  '["/Users/yourname/.claude/CLAUDE.md", "/Users/yourname/projects/myapp/MEMORY.md"]'

Tiers

Feature Free Starter Developer+
File sync Yes Yes Yes
hippodid:remember / hippodid:recall tools Yes Yes Yes
auto-recall (background injection) No Yes Yes
auto-capture (background save) No Yes Yes

See Tiers & Limits for full details.

Troubleshooting

“apiKey and characterId required” Config was not applied. Run the openclaw config set commands from Step 2 again and restart the gateway.

Plugin loads but tools not called by agent The bundled SKILL.md tells the agent when to use HippoDid tools. If the agent ignores them, try explicitly asking: use hippodid:recall to search for: <topic>

autoRecall / autoCapture shows as unavailable These features require Starter tier or above. Check your tier with hippodid:status or visit the dashboard.

Plugin id mismatch warning You may see: plugin id mismatch (manifest uses "hippodid-openclaw-plugin", entry hints "openclaw-plugin"). This is a cosmetic warning and does not affect functionality. It will be resolved in a future release.

Source & community

Copyright © 2026 SameThoughts. HippoDid is proprietary software. Open-source components (Spring Boot Starter, MCP Server) are Apache 2.0.

This site uses Just the Docs, a documentation theme for Jekyll.