OpenClaw Memory Knowledge — скилл

Хук и скилл для OpenClaw: наводят порядок в папках memory и knowledge, строят слои L0/L1/L2 и граф связей

  • 128 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Хук запускается в каждой новой сессии и переписывает структуру памяти агента.
Все причины и проверки

qiushi-dev/openclaw-memory-knowledge-management

Установка

Работает в

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

npx skillfoxx add skills/openclaw-memory-knowledge

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

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

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

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

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Хук запускается в каждой новой сессии и переписывает структуру памяти агента.

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

Что делает

Инструмент перестраивает память и знания агента OpenClaw в единую слоистую структуру. Старые файлы `memory/*.md` остаются нетронутыми, новая структура создается рядом в каталоге `.adaptr-v1/`. Содержимое раскладывается по восьми корзинам: люди, предпочтения, события, навыки, факты и другие. Для каждой корзины строятся индексы трех уровней L0, L1 и L2, от краткого описания до атомарных записей. Из текстов извлекаются сущности и связи, и получается запрашиваемый граф знаний. Новые данные принимаются инкрементально по принципу замены версии, а профили, события и рабочая память получают разные сроки хранения: постоянно, 90 и 7 дней. Периодическое самолечение убирает дубли и проверяет согласованность. Перед первой перестройкой старые данные копируются в соседний каталог.

Для кого. Пользователям OpenClaw, у которых папка memory разрослась, `MEMORY.md` обрезается, а поиск по памяти теряет часть записей.

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

  • `MEMORY.md` упирается в предел, и новые записи обрезаются.
  • Одна тема разбросана по трем дневниковым файлам, и поиск находит только один.
  • Каталог knowledge без общей структуры нужно связать графом.
  • Новые заметки должны автоматически дедуплицироваться при добавлении.

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

  • Вы работаете не в OpenClaw: хук и триггер привязаны к его рабочей области.
  • Память почти пуста, и перестраивать пока нечего.
  • Нужна векторная база с внешним сервисом эмбеддингов.

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

Установи этот хук, перестрой мою память и покажи отчет из `last_status.json`.

Ограничения

Инструмент работает только в OpenClaw и запускается при каждой новой сессии через хук: первая перестройка полная, дальше обрабатываются изменения. Проверка успеха идет по файлу `last_status.json`, который пишется после запуска. Поиск с дедупликацией опирается на штатный `memory search` OpenClaw, внешний сервис эмбеддингов не нужен. Описание в основном на китайском, есть английская версия. Лицензия в репозитории не указана. Перед использованием проверьте резервную копию старой памяти и не запускайте перестройку без нее.

Как отключить. Удалите хук и скилл из рабочей области OpenClaw. Каталог `.adaptr-v1/` и копию старых данных уберите вручную, если структура больше не нужна.

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

Как установить хук?

Отправьте OpenClaw архив `memory-knowledge-auto-migrate-hook.zip` и скажите установить хук. Агент прочитает `INSTALL.md` из архива и выполнит установку.

Как проверить, что перестройка прошла?

Откройте новую сессию, подождите одну-три минуты и найдите `.adaptr-v1/state/last_status.json`. Значение `summary.status` равное `ok` означает успех.

Что будет с моими старыми файлами?

Исходные `memory/*.md` остаются нетронутыми. Перед первой перестройкой старые данные копируются в соседний каталог.

Можно ли запустить без хука?

Да, есть ручной режим для разовой перестройки. Основной вход скрипта: `python scripts/auto_migrate.py`.

Нужен ли внешний сервис эмбеддингов?

Нет. Ни внешний HTTP-сервис эмбеддингов, ни сторонние зависимости в Python-части не требуются.

Обсуждение

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

Скиллы

Скилл долгой памяти хранит реплики, факты и эпизоды, сверяет найденное и обновляет устаревшее; для OpenClaw есть готовый плагин.

СкиллРасширенный доступ115Звезды репозитория

Self-Improving Agent

self-improving-agent

Скилл для OpenClaw: агент записывает ошибки, поправки и недостающие функции в файлы .learnings и переносит проверенное в память рабочей папки

СкиллРасширенный доступ790Звезды репозитория

Плагин долговременной памяти для агента OpenClaw на LanceDB: сам запоминает предпочтения и решения, гибридный поиск, забывание шума

ПлагинШирокий доступ4,5 тыс.Звезды репозитория
Официальный

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

СкиллШирокий доступ931Звезды репозитория

hipocampus дает агенту файловую память: индекс тем на 3000 токенов грузится в каждую сессию и подсказывает, что обсуждалось раньше

ПлагинРасширенный доступ211Звезды репозитория

ClawMem дает Claude Code, OpenClaw и Hermes локальную память: поиск по заметкам, хуки сессии и MCP-сервер на 33 инструмента

MCP-серверРасширенный доступ212Звезды репозитория

Коротко о README

Проект переносит идеи исследований агентской памяти (AdaMem и другие) в локальную файловую реализацию для OpenClaw и объясняет, какие упрощения сделаны.

Бейдж для README

Исходный SKILL.md

---
name: openclaw-memory-knowledge
description: 在 OpenClaw 中执行 memory/knowledge 的深度重构与持续增量入库。用于以下场景:已有 memory/knowledge 数据分散且结构混乱;需要一次性迁移到统一分层架构;需要后续新增数据自动按相同架构入库并去重;需要生成可审计报告以便排查与回滚。
triggers:
  - 用户上传文件名匹配 memory-knowledge-auto-migrate-hook.zip 或 memory-knowledge-auto-migrate-hook-*.zip 的压缩包,且明确表达“安装”意图
---

# OpenClaw Memory Knowledge

## 概览

这个 skill 负责两类事情:

1. 读取并重构已有 `memory/`、`knowledge/`,统一写入 AdaMem-lite + OpenViking 分层结构。
2. 对后续新增或变更内容做增量入库、版本替换、检索增强去重和自修复。

在当前版本里,除了原有 8 桶与 L0/L1/L2,还会额外生成:

- `layers/profile_snapshot.json`
- `layers/preferences_snapshot.json`
- `layers/retrieval_protocol.json`

并为每条 L2 记录补齐:

- `memory_function`
- `formation_mode`
- `trust_tier`
- `memory_policy`

默认运行入口:

```bash
python scripts/auto_migrate.py
```

这条命令会自动发现 OpenClaw 工作区并决定:

- 首次执行:`bootstrap`
- 后续执行:`ingest`
- apply 后:仅在有实质变更时执行 `self_evolve`

依赖边界:

- 不依赖任何外部 embedding HTTP 服务
- 检索增强去重依赖 OpenClaw 原生 `memory search`
- Python 侧无第三方 pip 依赖

## 首次安装

当用户上传 `memory-knowledge-auto-migrate-hook.zip` 或 `memory-knowledge-auto-migrate-hook-*.zip`,且明确要求安装时:

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