OpenClaw Integration

FatHippo plugs into OpenClaw as a context engine. Hosted mode now builds memory context before every non-trivial reply and records the completed exchange after the reply, while local mode follows the same turn rhythm entirely on-device.

Recommended Install

The default path is the interactive one-command installer. It installs the plugin, lets you choose your plan, handles configuration, and restarts OpenClaw for you.

npx @fathippo/connect openclaw

The installer prompts you to choose how you want to use FatHippo:

How do you want to use FatHippo?

  [1] Free (local-only) — memories stay on your machine, no account needed
  [2] Hosted ($4.99/mo) — cloud sync, cognitive features, cross-device memory

Choose [1/2]:

Plans

• Free (Local-Only) — $0/month: on-device memory, cross-session context recall, lightweight fix/workflow reuse, works offline, no account required.
• Hosted — $4.99/month or $49.99/year (save 17%): everything in Free, plus cloud sync across devices, cognitive traces & pattern extraction, skill synthesis, dashboard with receipts & analytics, plugin version management, and priority support.

Manual Fallback

If you need a manual path for a locked-down environment, you can still install the plugin directly and paste an API key yourself.

openclaw plugins install @fathippo/fathippo-context-engine
openclaw config set plugins.slots.contextEngine fathippo-context-engine
openclaw config set plugins.entries.fathippo-context-engine.config.mode hosted
openclaw config set plugins.entries.fathippo-context-engine.config.apiKey mem_your_key
openclaw config set plugins.entries.fathippo-context-engine.config.baseUrl https://fathippo.ai/api
openclaw gateway restart

Runtime Behavior

• Per-turn retrieval: hosted mode calls the FatHippo runtime context path before every non-trivial reply.
• Full-turn capture: the completed exchange is recorded after the reply, not one message at a time.
• Local parity: local mode retrieves before reply and persists after the completed turn on-device.
• Compaction: hosted mode still uses Dream Cycle on compaction when enabled.
• Subagents: FatHippo keeps the same OpenClaw memory scope across spawned sessions and best-effort closes hosted sessions when possible.

Configuration

New installs should not set captureUserOnly. Full-turn capture is now the default. KeepcaptureUserOnly: true only if you explicitly want the older conservative behavior.

{
  "plugins": {
    "slots": {
      "contextEngine": "fathippo-context-engine"
    },
    "entries": {
      "fathippo-context-engine": {
        "enabled": true,
        "config": {
          "mode": "hosted",
          "apiKey": "mem_your_key",
          "baseUrl": "https://fathippo.ai/api",
          "namespace": "my-project",
          "installationId": "oc_machine_01",
          "injectCritical": true,
          "injectLimit": 20,
          "dreamCycleOnCompact": true,
          "hippoNodsEnabled": true
        }
      }
    }
  }
}

What OpenClaw Does For You

Before The Reply

FatHippo runtime:
- memory context from /v1/simple/context
- indexed summaries
- active constraints
- cognitive traces/patterns for coding-like requests

After The Reply

FatHippo runtime:
- records the completed turn
- extracts durable memories from the exchange
- updates or merges existing memories when needed
- stores constraints detected from the turn
- captures a coding trace when the exchange looks like a real fix flow

Compatibility Notes

• Legacy behavior: captureUserOnly: true is still supported as an opt-out.
• Package name: OpenClaw should install @fathippo/fathippo-context-engine.
• One-command install: @fathippo/connect stays a separate package so the command remains clean.