Agentic Memory

Self-Hosted Backend

Run your own Agentic Memory backend and point the OpenClaw plugin at it.

What you need

  • Neo4j 5.x+ with GDS and vector index support
  • Python 3.11+ environment for am-server
  • A valid embedding provider API key (Gemini by default)
  • OpenClaw host with plugin install support

1. Start Neo4j

docker compose up -d neo4j

Default connection: bolt://localhost:7687 with user neo4j and password password.

2. Start am-server

python -m am_server.server

By default the server listens on http://127.0.0.1:8765. Use environment variables or a .env file to configure Neo4j credentials, API keys, and auth.

3. Configure the OpenClaw plugin

openclaw agentic-memory doctor --self-hosted --backend-url http://127.0.0.1:8765 openclaw agentic-memory setup --self-hosted --backend-url http://127.0.0.1:8765

Environment variables

VariablePurpose
NEO4J_URINeo4j Bolt URI
NEO4J_USERNeo4j username
NEO4J_PASSWORDNeo4j password
GEMINI_API_KEYEmbedding provider key (default)
AM_SERVER_API_KEYSComma-separated bearer tokens for /openclaw/* and /metrics

Deployment runbook

For production deployments, health checks, rollback steps, and capacity planning, see the full Self-Hosted Setup guide.

Back to Quickstart