Console Docs

mem9 Console User Guide

mem9 Console is the hosted control center for projects, memory spaces, API keys, memory review, Space Chains, usage, billing, and account settings. This guide explains the product from the user workflow, not from the API contract.

Quick Start

Use Console after you have a mem9 account or an API key you want to manage.

  • Open mem9 Console from the Log in menu and sign in with your account.
  • Choose the organization and project from the shell before changing resources.
  • Use Install mem9 when you need the official OpenClaw onboarding prompt.
  • Use Claim API key when you already have a mem9 API key and want to attach it to a Space.
  • Open Space or Memories to review what your agents are storing.

Organization, Project, and Space

Console groups resources so a team can manage memory without mixing every key together.

Organization

An organization owns billing, usage, settings, and member-level permissions. The sidebar organization selector changes which organization you are operating in.

Project

A project is the working container for spaces and Space Chains. Use the project switcher in the header to move between products, environments, or teams.

Space

A Space is the unit that receives a mem9 tenant API key. Your agents write and recall memories through that key, while Console uses the Space to show metrics, keys, imports, and memory tools.

Install mem9 and Claim API Keys

There are two common onboarding paths.

Install mem9

  • Open Install mem9 in the sidebar.
  • Copy the onboarding prompt into OpenClaw.
  • Follow SKILL.md to provision or reconnect a hosted mem9 API key.
  • Return to Console when you want to inspect spaces and memory activity.

Claim an existing API key

  • Open the claim flow when you already have an anonymous or previously generated mem9 API key.
  • Choose an organization, project, and destination Space.
  • Create a new Space or attach the key to an existing Space without an active key.
  • After a successful claim, open that Space to inspect the key and memory data.

Spaces

The Space page is the project-level list of memory spaces.

  • Create a Space for a product, environment, agent group, or isolated memory boundary.
  • Use the table to compare names, descriptions, and whether each Space already has an API key.
  • Open a Space by selecting its name.
  • Use the row actions to edit the Space, configure or replace its key, or delete it when it is no longer needed.

Space Detail

Space detail is where a Space becomes operational.

Tenant key

  • Configure a key before expecting memory data to load.
  • Reveal and copy an active key only when your role can manage the Space.
  • Treat revealed keys as secrets; Console shows masked keys by default.

Metrics and imports

  • Use metric cards to check total, pinned, and insight memories.
  • Use the latest import panel to see whether imports are running, completed, or failed.
  • Use the Space switcher to compare another Space without returning to the list.

Memory workbench

  • Create a memory directly from Console.
  • Turn on Smart ingest when you want Console to extract durable facts from a pasted message.
  • Edit, delete, bulk delete, filter, sort, and refresh active memories.
  • Use appId when you need to isolate memories within the same Space key.

Memories

The Memories page is a project-level explorer for one selected Space.

  • Pick a Space from the header selector.
  • Filter by text, type, state, agent, tags, or appId.
  • Open a memory to inspect content, metadata, tags, score, confidence, session, agent, version, and timestamps.
  • If the selected Space has no key, open Space key settings before browsing memories.

Space Chains

A Space Chain lets one chain key recall across several Spaces in a controlled order.

Create or import

  • Create Space Chain to start a new chain in the current project.
  • Import key when you already have a chain key and want Console to manage or test it.
  • Open a chain to edit its details, keys, nodes, and memory tools.

Nodes and routing

  • Add Spaces that already have active keys.
  • Move nodes up or down to control recall order.
  • Save node order before depending on chain recall.
  • Use routing policy prompts on nodes when a Space should only be searched for certain kinds of questions.

Chain keys and testing

  • Create or bind chain keys from the detail page.
  • Disable a chain key when it should no longer be used.
  • Use the recall and memory tools to compare chain behavior with a single Space.

Webhooks

The Webhooks page manages event subscriptions for Spaces and Space Chains in the current project.

Project view

  • Open Webhooks from the Activity sidebar.
  • Use All, Space, or Space Chain filters to narrow the project-level list.
  • The table shows the endpoint name, scope, URL host, enabled state, subscribed events, last delivery status, and update time.
  • If one Space is not usable, the project list continues to show reachable scopes instead of blocking the whole page.

Create and edit

  • Create Webhook opens a modal where you choose Space or Space Chain, pick the resource, enter the URL, select events, and enable or disable the endpoint.
  • Production endpoints should use HTTPS. Local HTTP URLs are only for local development receivers.
  • The signing secret is shown only after create or rotate-secret. Copy it before closing the modal.

Actions and deliveries

  • Use the row menu to edit, test, view deliveries, rotate the signing secret, enable or disable, or delete an endpoint.
  • Test queues a `webhook.test` delivery so you can verify the receiver before relying on live events.
  • The deliveries drawer shows event type, event id, delivery status, attempt count, HTTP status, last error, retry time, and delivered time.

Usage, Billing, and Settings

These pages operate at the organization level.

Usage

  • Review memory recall and memory write request usage.
  • Change the date range, inspect daily trends, and page through usage events.
  • Use event rows to understand source, API key, agent, included usage, and on-demand usage.

Billing

  • Review the current plan, subscription period, included launch access, and on-demand settings.
  • Payment, subscription, and invoice actions may appear as coming soon depending on the rollout state.

Settings

  • Use Settings for account and organization-level management as Console evolves.
  • Use the account menu for theme, language, and logout.

Pricing

mem9 pricing is based on monthly Add Request and Retrieval Request quotas. Free has fixed included usage, while paid plans can extend with on-demand usage when billing controls are configured.

Public pricing intentionally exposes two usage meters: Add Requests and Retrieval Requests. Core Console workflows stay consistent across plans; the main tier differences are included quota, support level, on-demand behavior, and enterprise contract options.

Plans and included usage
PlanMonthly priceAdd requestsRetrieval requestsEnd usersSupportOn-demand
Free$013,000 / month1,300 / monthUnlimitedCommunityNot available; fixed monthly quota
Starter$9 / month65,000 / month6,500 / monthUnlimitedEmailAvailable with payment method and spend cap
Pro$120 / month650,000 / month65,000 / monthUnlimitedPriorityAvailable with payment method and spend cap
EnterpriseCustomUnlimited or custom contract termsUnlimited or custom contract termsUnlimitedDedicated support and custom SLACustom commercial terms
Capability and billing differences by tier
CapabilityFreeStarterProEnterprise
Core Console workflowsSpaces, memory review, Space Chains, usage, billing, and settingsSpaces, memory review, Space Chains, usage, billing, and settingsSpaces, memory review, Space Chains, usage, billing, and settingsCore workflows plus custom enterprise support
Monthly quotasFixed included usage onlyHigher included quota for small teams and early productsHigher included quota for production or heavier agent usageUnlimited or negotiated quota
On-demand usageNo on-demand billing; upgrade or wait for the next billing cycle after limits are reached$0.20 / 1,000 Add Requests and $2.00 / 1,000 Retrieval Requests$0.20 / 1,000 Add Requests and $2.00 / 1,000 Retrieval RequestsCustom terms
Spend capNot applicableRequired before auto top-up can runRequired before auto top-up can runContracted limits or account terms
SupportCommunityEmailPriorityDedicated support and custom SLA
Enterprise optionsNot includedNot includedNot includedSecurity review, dedicated support, custom SLA, BYOK, dedicated retention, or large-scale storage terms can be handled by contract

Request definitions

An Add Request is one memory write or memory distillation operation. It can process messages, text, events, or structured facts into durable memory.

A Retrieval Request is one memory query or recall operation scoped by user, agent, app, Space, metadata filter, or query text.

  • An Add Request can include fact extraction, memory creation, memory update, deduplication, reconciliation, embedding, and storage write.
  • A Retrieval Request can include semantic search, keyword search, hybrid search, metadata filtering, ranking, and result assembly.
  • For Space Chains, one recall counts as one Retrieval Request even if the chain scans multiple Spaces.
  • Very large payloads, long conversation imports, very large top_k, unusually broad multi-Space recall, or abnormal high-frequency usage may be handled by fair-use policy or Enterprise pricing.

On-demand usage, auto top-up, and spend caps

Free does not support on-demand overage billing. When a Free account reaches its included quota, it must upgrade or wait for the next billing cycle.

Starter and Pro users can enable auto top-up after adding a valid payment method. Users should configure a monthly spend cap before relying on on-demand usage. Once the hard cap is reached, overage API calls are paused until the next billing cycle or until the cap is increased.

On-demand rates for paid self-serve plans
Usage meterRateApplies to
Add Request$0.20 / 1,000 requestsStarter and Pro
Retrieval Request$2.00 / 1,000 requestsStarter and Pro

Coupon codes

To use a coupon code, click Upgrade Plan from Console Billing or Subscribe from the pricing page, choose a plan, and review the Payment summary. Enter the code in the Coupon code field before completing payment.

A coupon code can be used only once per account. Startups can email a short summary of their company, product, stage, expected mem9 usage, and requested support to mem9@pingcap.com to apply for a coupon code.

Billing rules FAQ

Common billing rules
QuestionAnswer
Do monthly quotas roll over?No. Included monthly quotas reset every billing cycle and do not roll over.
Do failed requests count?Client-side validation errors and platform errors are not billed. Successfully processed requests may be billed even if no new memory is created.
Do duplicate or no-op Add Requests count?Yes, if extraction, deduplication, or reconciliation has already been executed.
Is storage billed separately?Storage is included under normal usage. Large-scale storage or dedicated retention requirements may be handled through Enterprise pricing.
Can customers bring their own LLM key?BYOK can be supported for Enterprise customers. In that case, LLM cost may be excluded from mem9 usage pricing or handled as pass-through cost.

Safe Operations

Console exposes powerful controls, so treat changes deliberately.

  • Do not reveal or copy API keys unless you are about to configure a trusted client.
  • Check delete previews and confirmation dialogs before deleting Spaces or Space Chains.
  • Use separate Spaces for data that should not be searched together.
  • Use appId filters when a single key serves multiple applications.
  • When memory results look wrong, first check the selected organization, project, Space, key status, and appId filter.