Memory Providers

In addition to local file-based memory, MonoClaw supports external memory providers that offer advanced features like semantic search, user modeling, and cross-device sync.

Available providers

Honcho (recommended)

Honcho is the most capable memory provider. See the dedicated Honcho guide for setup instructions.

Quick setup

Switch memory providers:

monoclaw config set memory.provider honcho
monoclaw config set HONCHO_API_KEY "your-key"

Or in config.yaml:

memory:
  provider: mem0
  mem0:
    api_key: "${MEM0_API_KEY}"

Provider comparison

Local vs cloud

Switching providers

monoclaw memory provider switch honcho

Existing local memories are preserved but not automatically migrated. Export first:

monoclaw memory export > backup-memory.md

Custom memory providers

You can build a custom memory provider as a plugin. Implement the MemoryProvider interface:

from monoclaw.plugins import MemoryProvider

class MyMemoryProvider(MemoryProvider):
    def store(self, key: str, value: str) -> None:
        ...

    def retrieve(self, query: str) -> list[str]:
        ...

    def delete(self, key: str) -> None:
        ...

Register it in your plugin's plugin.yaml:

memory_providers:
  my_provider: MyMemoryProvider

Troubleshooting