MindMemOS — скилл

Долговременная память для ИИ-агентов: скилл и команда mindmemos сохраняют факты из диалогов и находят их в новых сессиях

920 ★ репозитория
Последний коммит 29 авг. 2026

Скилл Официальный

mindscale-noah/mindmemosАвтор:mindscale-noah

Установка

Работает в: Claude Code
Codex
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/mindmemos

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Плагин записывает диалог в конце каждого хода, а в сообщениях бывают личные данные, ключи и рабочие секреты
В облачном режиме отправляет сообщения на внешний сервер и хранит ключ API в файле `~/.mindmemos/settings.json`
Команды `memory delete`, `memory update` и `skill push` меняют и удаляют данные на сервере

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MindMemOS — слой долговременной памяти для ИИ-агентов. В репозитории он представлен сервером, Python-пакетом `mindmemos-sdk` с командой `mindmemos`, скиллом `mindmemos-cli` и плагинами для OpenClaw и DeepSeek Harness. Агент ставит CLI командой `pip install mindmemos-sdk` (или через `pipx`, или `uv tool install`), один раз выполняет `mindmemos auth` с адресом сервиса, ключом API и идентификатором пользователя, а дальше управляет памятью подкомандами. Команда `memory add` отправляет сообщения на сервер, тот выделяет устойчивые факты и сливает их с уже сохраненными. `memory search` возвращает записи по смыслу: стратегия `fast` ищет по векторам, `agentic` рассуждает по нескольким записям, а ключи `--rerank` и `--token-budget` повышают точность и ограничивают объем ответа. Остальное — `get`, `update` и `delete` по идентификатору, `feedback` для исправления неудачного воспоминания и `dreaming`, фоновое слияние и сжатие накопленного. Плагин OpenClaw вызывает тот же CLI сам: перед каждым запросом ищет воспоминания и подставляет их, а в конце хода записывает диалог. Сервер можно взять готовый на `https://mindmemos.cn`, ключ выдает сайт, или развернуть у себя: `make dev` поднимает в Docker `Qdrant`, `Neo4j` и `Kafka`, а затем FastAPI на порту 8000, в `dev.yaml` задаются модели для генерации, эмбеддингов и, по желанию, переранжирования. Подкоманды `mindmemos skill` регистрируют локальные скиллы, выгружают их версии на сервер и откатывают.

Для кого. Для разработчиков, которые хотят, чтобы агент помнил предпочтения пользователя и факты проекта между сессиями, и готовы подключить облачный сервис MindMemOS или держать свой сервер.

Подходит, если

Агент должен помнить предпочтения пользователя и решения по проекту между сессиями: `memory add` в конце хода, `memory search` в начале
Одну память нужно отдать нескольким агентам: проекты разделяет ключ API, а внутри проекта записи делятся по `--user-id`, `--app-id`, `--agent-id` и `--session-id`
Сохраненное нужно проверить или почистить: `memory get` с фильтром и `memory delete <id> --yes`
Агент работает в OpenClaw или DeepSeek Harness, и память должна подключаться плагином без правок промптов
Нужна фоновая уборка памяти по расписанию: `memory dreaming` объединяет и сжимает накопленные записи

Не подходит, если

Диалоги нельзя отправлять на внешний сервер, а ресурсов на свой нет: облако `mindmemos.cn` получает сообщения, локальному серверу нужен Docker с несколькими сервисами
Нужна память в локальных Markdown-файлах без сервера: ближе Basic Memory, он хранит заметки файлами с графом связей
Нужен готовый плагин для Claude Code: плагины в репозитории есть только для OpenClaw и DeepSeek Harness, в остальных случаях агент вызывает CLI сам
Не хочется настраивать модели: локальный сервер требует задать модели для генерации и эмбеддингов в `dev.yaml`

Пример запроса к агенту

Запомни, что в этом проекте мы используем pnpm и не трогаем папку legacy, и сверяйся с этим перед правками в следующих сессиях

Ограничения

CLI работает только через сервер: облачный `https://mindmemos.cn` с ключом с сайта или локальный `http://127.0.0.1:8000`. Адрес и ключ лежат в файле `~/.mindmemos/settings.json`.
Проект официально выпущен 30 июня 2026 года. Лицензия MIT указана в документации, отдельного файла лицензии в репозитории нет.
Плагину OpenClaw мало установки: без параметра `allowConversationAccess` запись после хода молча блокируется, а поиск работает, и плагин выглядит исправным. Если OpenClaw запущен из графической оболочки, он может не найти `mindmemos` в PATH, тогда в настройке `cli` указывают абсолютный путь.
`memory search` не берет `--user-id` из `mindmemos auth`: без параметра поиск идет по всему проекту, привязанному к ключу.
Схема извлечения воспоминаний выбирается параметром `algo_config.add.schema.version`, по умолчанию `v2`.

Как отключить. Для OpenClaw отключите плагин в настройках: запись `plugins.entries.mindmemos-memory`, параметр `enabled`. CLI удаляется командой `pip uninstall mindmemos-sdk`, а каталог `~/.mindmemos` удалите вручную. Воспоминания на сервере стираются командой `mindmemos memory delete <id> --yes`.

Частые вопросы

Как подключить долговременную память к ИИ-агенту?

Поставьте `mindmemos-sdk`, выполните `mindmemos auth` и дайте агенту скилл `mindmemos-cli`: в нем описаны команды `memory add` и `memory search`. Для OpenClaw и DeepSeek Harness есть плагины, которые ищут и записывают воспоминания сами.

Чем отличаются стратегии поиска fast и agentic?

`fast` ищет по векторам и подходит там, где важна скорость. `agentic` рассуждает по нескольким воспоминаниям и нужен, когда ответ складывается из нескольких записей. Ключ `--rerank` дополнительно переупорядочивает кандидатов ради точности.

Как память делится между пользователями и проектами?

Проект определяется ключом API, отдельный параметр не нужен. Внутри проекта записи различают `--user-id`, `--app-id`, `--agent-id` и `--session-id`. Поиск без `--user-id` идет по всему проекту.

Можно ли держать память у себя, без облака?

Можно. Скопируйте `.env.example` и `config/mindmemos/dev.example.yaml`, задайте модели генерации и эмбеддингов, внесите ключ в `config/mindmemos/api_keys.yaml` и выполните `make dev`. Сервер слушает порт 8000, а CLI настраивается на `http://127.0.0.1:8000`.

Что делает команда dreaming?

`memory dreaming` запускает фоновый проход, который объединяет, сжимает и перестраивает накопленные воспоминания. Ее ставят на расписание, а не на каждый ход. По умолчанию команда уходит в очередь, ключ `--sync` ждет результата.

Как исправить неверное воспоминание?

Если известен идентификатор, `memory update mem_123 --content "..."` перепишет запись, а `memory delete mem_123 --yes` удалит. Если нужен сигнал о плохом припоминании, `memory feedback --text "..."` передает серверу исправление вместе с сообщениями того хода.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Memmy

Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые

CLIШирокий доступ2,1 тыс.

Supermemory

Официальный

Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений

MCP-серверРасширенный доступ31,4 тыс.

Hindsight

Официальный

Система долговременной памяти для AI-агентов: агент сохраняет опыт и факты, а затем находит их через встроенный MCP-сервер

MCP-серверШирокий доступ52,9 тыс.

Memori

Скилл для Claude Code, который перед каждым нетривиальным ответом сам подтягивает память из Memori Cloud и записывает туда новые факты

СкиллРасширенный доступ17,1 тыс.

memsearch

Общая семантическая память для агентов: разговоры сохраняются в markdown и находятся поиском в Claude Code, Codex и других агентах

ПлагинРасширенный доступ2,8 тыс.

agent-memory

Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других

CLIРасширенный доступ4,6 тыс.

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
MindMemOS (эта запись)	да		920
Claude-Mem	нет		102 374	плагин постоянной памяти: сохраняет наблюдения из сессий агента и подставляет нужный контекст в новые сессии
Basic Memory	нет	не нужна	4 334	долговременная память в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом

Коротко о README

В репозитории лежат серверная часть на Python, настройки в `config/mindmemos`, файлы Docker, тесты, два плагина в папке `plugins` и скилл в `skills/mindmemos-cli` с тремя справочными файлами про OpenClaw, DeepSeek Harness и Python SDK. Документация начинается с новостей и списка возможностей, дальше идут два способа развертывания и четыре способа доступа с таблицей адресов, примеры на curl, SDK и CLI, сравнение на бенчмарке и раздел о лицензии.

Бейдж для README

Исходный SKILL.md

---
name: mindmemos-cli
description: Give an AI agent persistent, cross-session long-term memory through MindMemOS. Covers installing and authenticating the mindmemos CLI, the full command interface (add / search / get / update / delete / feedback / dreaming) with parameters and examples, guidance on which capability to use when, plus a Python SDK example. To wire memory into a specific agent host (OpenClaw, DeepSeek Harness, Codex, Claude, etc.), see references/.
---

# MindMemOS CLI

MindMemOS is a long-term memory layer for AI agents. The `mindmemos` CLI is the
integration surface: every memory operation is a subcommand that prints either a
human-readable line or, with `--json`, stable machine-readable output. Any agent
or script can drive memory by shelling out to it.

To connect memory to a specific agent host (e.g. an editor or assistant that
supports plugins), the host calls this same CLI. Host-specific install guides
live under `references/` — see [Host integrations](#host-integrations).

---

## Install the CLI

The CLI ships as the Python package `mindmemos-sdk` and exposes a `mindmemos`
executable.

```bash
pip install mindmemos-sdk
# or, isolated so it's on PATH globally (recommended):
pipx install mindmemos-sdk
uv tool install mindmemos-sdk
```

Authenticate once. This writes a local config (API key, default user id, base URL). Operations that require a
user inherit the default user id, but `memory search` does not: omit `--user-id` for project-wide search or pass
it explicitly for user-scoped search.

```bash
mindmemos auth
# non-interactive:
mindmemos auth --api-key sk-... --user-id alice --base-url https://api.mindmemos.example.com
```

Verify:

```bash
mindmemos config show # masked key, base_url, user_id
mindmemos memory search "test" # confirms connectivity with a project-wide search
```

---

## CLI interface

Сообщить о проблеме