@getplumb/plumb — Plumb Memory Plugin for OpenClaw

Persistent memory for OpenClaw — automatic ingest and context injection, no setup required.

Made by Plumb · GitHub · npm

This is the official OpenClaw memory plugin from Plumb (plumb.run). It replaces OpenClaw's default memory-core slot with a persistent SQLite-backed memory that learns from your conversations and injects relevant context automatically.

Install

openclaw plugins install @getplumb/plumb

Then restart the gateway to activate:

openclaw gateway restart

That's it. Plumb starts learning from your conversations immediately.

Note on security warning: OpenClaw may show a warning about "environment variable access combined with network send." This is expected — Plumb reads your configured LLM API key and uses it to extract memory facts from conversations. No credentials are sent anywhere except the LLM provider you configure. You can safely proceed past this warning.

What it does

• Auto-ingest — every conversation turn is stored to a local SQLite DB after the response
• Context injection — relevant memory facts are injected into the system prompt before each response
• Shadow mode — observe what would be injected without actually injecting it (good for testing)
• Local only — all data stays on your machine; nothing is sent to external servers

Configuration

Configuration lives under plugins.entries.plumb.config in your openclaw.json. All fields are optional — defaults work out of the box.

| Field | Default | Description | |---|---|---| | dbPath | ~/.plumb/memory.db | Path to the SQLite database file | | userId | default | User ID for scoping memory | | shadowMode | false | If true, retrieves context but does not inject it | | llmProvider | (inherits from OpenClaw) | LLM provider for fact extraction (openai, anthropic, ollama, openai-compatible) | | llmModel | (inherits from OpenClaw) | Model for fact extraction | | llmApiKey | (inherits from OpenClaw) | API key for fact extraction |

To configure via CLI:

openclaw config set plugins.entries.plumb.config.userId "clay"
openclaw gateway restart

Uninstall

openclaw plugins uninstall @getplumb/plumb

Then manually restore the memory slot in your openclaw.json — OpenClaw does not do this automatically:

"plugins": {
  "slots": {
    "memory": "memory-core"
  },
  "entries": {
    "memory-core": { "enabled": true }
  }
}

Remove any "plumb" blocks from plugins.entries and plugins.installs, then restart:

openclaw gateway restart

Note: Skipping the manual config cleanup will leave OpenClaw with a broken memory slot. This is a known gap in the OpenClaw plugin uninstall flow — filed as an issue.

Links

• Plumb
• OpenClaw

License

MIT