Persistent Cloud Memory Plugin

---
name: persistent-cloud-memory-plugin
description: "Persistent cloud memory plugin for OpenClaw. This document routes setup, troubleshooting, and uninstall flows and defines config boundaries."
category: "Community"
author: community
version: "1.0.38"
icon: puzzle
---

# mem9

mem9 is the persistent cloud memory plugin for OpenClaw. It keeps durable memory across sessions and machines.

This top-level `SKILL.md` is a routing and safety document. It is the entry point for setup, troubleshooting, and uninstall flows. It is not the canonical reference for runtime request behavior.

## What This Skill Does

- Route first-time install, reconnect, config review, and mainland China / Alibaba Cloud npm mirror fallback handling to `SETUP.md`.
- Route setup failures, recovery work, and broken local state to `TROUBLESHOOTING.md`.
- Route local mem9 removal on this machine to `UNINSTALL.md`.
- Keep history import manual. Do not scan or upload local memory or session files from this skill.

## Source / Runtime Authority

- Official source: [mem9-ai/mem9](https://github.com/mem9-ai/mem9) and [mem9.ai](https://mem9.ai/).
- Default setup network target is `https://api.mem9.ai` unless the user explicitly chooses another `apiUrl`.
- The installed mem9 plugin contains the actual OpenClaw integration, request logic, default base URL handling, and runtime behavior.
- This `SKILL.md` is not the backend API contract and does not define day-to-day memory semantics.
- For OpenClaw-specific runtime details, use the plugin README: [openclaw-plugin/README.md](https://github.com/mem9-ai/mem9/blob/main/openclaw-plugin/README.md).

## Allowed Config Scope

Only these `openclaw.json` paths may be changed during setup:

- `plugins.slots.memory`
- `plugins.entries.mem9.enabled`
- `plugins.entries.mem9.config.apiUrl`
- `plugins.entries.mem9.config.apiKey`
- `plugins.entries.mem9.config.provisionQueryParams` for create-new only, and only when the remote `SKILL.md` URL contains filtered `utm_*` parameters
- `plugins.allow`

Do not change any other config keys unless the user explicitly asks.

## Routing

- Install, enable, reconnect, or review mem9 config changes: read `SETUP.md`.
- Setup failures, broken reconnects, local cleanup issues, or recovery guidance: read `TROUBLESHOOTING.md`.
- Uninstall, remove, disable, or roll back mem9 on this machine: read `UNINSTALL.md`.
- If an uninstall request also mentions `reset session`, `restart gateway`, `重启网关`, clearing local mem9 history, or equivalent, still route to `UNINSTALL.md` first and keep those actions as post-verification follow-up only.
- If this skill is loaded remotely, resolve `SETUP.md`, `TROUBLESHOOTING.md`, and `UNINSTALL.md` relative to the directory containing the current `SKILL.md`.

## Definition of Done

- The correct supporting document was used for the user's intent: `SETUP.md`, `TROUBLESHOOTING.md`, or `UNINSTALL.md`.
- No `openclaw.json` paths outside the allowed scope were changed.
- Runtime behavior claims defer to the installed plugin and its README, not to this top-level routing document.
- Public setup guidance keeps China network registry handling inside npm-native install flow and avoids direct registry probe commands.