OpenClaw Quickstart

Prerequisites

• An Agentic Memory backend that is already reachable.
• A real bearer token from the backend's AM_SERVER_API_KEYS.
• An OpenClaw host version compatible with the plugin package.

If you still need the backend, start with the Self-Hosted Backend guide.

1. Install the plugin

openclaw plugin install agentic-memory-openclaw

Important identity split:

• npm package name: agentic-memory-openclaw
• runtime OpenClaw plugin id after install: agentic-memory

2. Configure the plugin

Choose the mode that matches the backend you are pointing at.

Managed hosted example

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

Self-hosted example

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

Recommended order: install → doctor → setup.

doctor reads the backend onboarding contract at /health/onboarding and tells you whether the backend is merely reachable or actually ready.

3. Verify the connection

openclaw agentic-memory project status

Then verify the backend directly:

curl http://127.0.0.1:8765/health curl -H "Authorization: Bearer replace-with-real-rest-key" \ http://127.0.0.1:8765/openclaw/health/detailed curl -H "Authorization: Bearer replace-with-real-rest-key" \ http://127.0.0.1:8765/metrics

4. Session-level project 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

These commands are session-scoped. They do not permanently bake one project id into the install-time plugin config.

Roll back

Disable or remove the installed OpenClaw plugin through your host's plugin management flow. If you are testing multiple package revisions, reinstall the desired version and re-run openclaw agentic-memory setup.