Agentic Memory

Setup Reference

Everything you need to configure the Agentic Memory OpenClaw plugin after installation.

doctor

The doctor command asks the backend for the whole-stack onboarding contract and reports whether the requested mode is honestly ready.

openclaw agentic-memory doctor --hosted --backend-url https://backend.agentmemorylabs.com

It distinguishes between:

  • backend is merely reachable
  • backend is ready for OpenClaw capture-only
  • backend is ready for OpenClaw augment-context

setup

The setupcommand writes the plugin's live OpenClaw config. It can run as an interactive wizard or as a non-interactive command.

openclaw agentic-memory setup \ --backend-url https://backend.agentmemorylabs.com \ --api-key "${AGENTIC_MEMORY_API_KEY}" \ --device-id my-device \ --agent-id my-agent \ --mode capture_only

By default, setup refuses to persist config when the requested mode is not ready. Override with:

openclaw agentic-memory setup --allow-degraded

Config schema

Setup writes the following config shape under plugins.entries.agentic-memory.config:

PropertyTypeDescription
schemaVersionintegerConfig migration version. Defaults to 1.
backendUrlstringAgentic Memory backend URL.
apiKeystringBearer token. Prefer env interpolation such as ${AGENTIC_MEMORY_API_KEY}.
deviceIdstringStable identifier for the current device.
agentIdstringStable identifier for the current OpenClaw agent.
modestringcapture_only or augment_context. Defaults to capture_only.
workspaceIdstringOptional workspace override.
contextEngineIdstringContext engine slot id. Defaults to agentic-memory.

Project commands

Project scoping is a runtime concern. After setup, use these session-scoped commands:

openclaw agentic-memory project init <project-id> openclaw agentic-memory project use <project-id> openclaw agentic-memory project status openclaw agentic-memory project stop