memory-wiki — это встроенный плагин, который преобразует устойчивые знания в
удобную для навигации вики: детерминированные страницы, структурированные утверждения с доказательствами,
происхождение данных, панели мониторинга и машиночитаемые дайджесты.
Он не заменяет плагин активной памяти. Извлечение, продвижение, индексирование и
Dreaming остаются в ведении настроенного бэкенда памяти
(memory-core, QMD, Honcho и т. д.). memory-wiki работает рядом с ним и преобразует
знания в поддерживаемый вики-слой.
Практическое правило:
memory_searchдля одного широкого прохода извлечения по всем настроенным корпусамwiki_search/wiki_get, когда нужны специфичные для вики ранжирование, происхождение данных или структура убеждений на уровне страницыmemory_search corpus=all, чтобы охватить оба слоя одним вызовом, если плагин активной памяти поддерживает выбор корпуса
memory-wiki в режиме bridge для устойчивых синтезированных страниц. См.
пример QMD + режим моста в разделе Конфигурация.
Если режим моста сообщает о нулевом количестве экспортированных артефактов, значит плагин активной памяти
в настоящее время не предоставляет общедоступные входные данные моста. Сначала выполните openclaw wiki doctor,
затем убедитесь, что плагин активной памяти поддерживает общедоступные артефакты.
Режимы хранилища
isolated(по умолчанию): собственное хранилище, собственные источники, без зависимости от плагина активной памяти. Используйте для автономного курируемого хранилища знаний.bridge: читает общедоступные артефакты памяти и журналы событий из плагина активной памяти через общедоступные интерфейсы SDK плагинов. Используйте для компиляции экспортированных артефактов плагина памяти без обращения к закрытым внутренним компонентам плагина.unsafe-local: явный аварийный механизм для локальных закрытых путей на том же компьютере. Намеренно экспериментальный и непереносимый; используйте только тогда, когда понимаете границу доверия и вам требуется доступ к локальной файловой системе, который не может обеспечить режим моста.
vaultModeопределяет, откуда поступают входные данные вики.vault.scopeопределяет, используют ли все агенты одно хранилище или каждый агент получает дочернее хранилище.
vault.scope: "global" используется по умолчанию и сохраняет существующее поведение
с единым хранилищем. Используйте vault.scope: "agent" с режимом isolated или bridge, если
агенты не должны совместно использовать вики-страницы, скомпилированные дайджесты, результаты поиска или записи.
Область агента нельзя сочетать с режимом unsafe-local, поскольку настроенные
закрытые пути не являются входными данными, принадлежащими агенту. Проверка конфигурации отклоняет это
сочетание.
Режим моста может индексировать в зависимости от переключателя конфигурации bridge.*:
- экспортированные артефакты памяти (
indexMemoryRoot) - ежедневные заметки (
indexDailyNotes) - отчёты Dreaming (
indexDreamReports) - журналы событий памяти (
followMemoryEvents)
bridge.readMemoryArtifacts,
openclaw wiki status, openclaw wiki doctor и openclaw wiki bridge import направляются через работающий Gateway, поэтому используют тот же контекст активного
плагина памяти, что и память агента/среды выполнения. Если мост отключён или чтение
артефактов выключено, эти команды сохраняют локальное/автономное поведение.
Структура хранилища
sources/: импортированные исходные материалы и страницы, основанные на данных моста/небезопасных локальных данныхentities/: устойчивые сущности, люди, системы, проекты, объектыconcepts/: идеи, абстракции, шаблоны, политики (также место назначения для импорта OKF)syntheses/: скомпилированные сводки и поддерживаемые агрегированные данныеreports/: сгенерированные панели мониторинга
Импорт Open Knowledge Format
memory-wiki
преобразует его в нативные для OpenClaw страницы концепций и скомпилированные дайджесты.
- незарезервированные файлы
.mdявляются документами концепций - для каждой импортированной концепции требуется непустое поле метаданных
type; отсутствиеtypeприводит к предупреждениюmissing-type, и файл пропускается - неизвестные значения
typeпринимаются как универсальные концепции index.mdиlog.mdзарезервированы и никогда не импортируются как концепции- неработающие или внешние ссылки Markdown остаются без изменений
concepts/, поэтому существующие процессы компиляции, поиска, получения и
создания панелей мониторинга видят их без второго дерева вики. Каждая страница сохраняет
исходный идентификатор концепции OKF, путь к источнику, type, resource, tags, временную метку
и все метаданные производителя. Внутренние ссылки OKF переписываются так, чтобы указывать на сгенерированные
страницы концепций вики, а также создают структурированные записи relationships с
kind: okf-link.
Структурированные утверждения и доказательства
Страницы содержат структурированные метаданныеclaims, а не только неструктурированный текст. Каждое
утверждение может включать id, text, status, confidence, evidence[] и
updatedAt. Каждая запись доказательства может включать kind, sourceId, path,
lines, weight, confidence, privacyTier, note и updatedAt.
Благодаря этому вики работает как слой убеждений, а не как пассивное хранилище заметок.
Утверждения можно отслеживать, оценивать, оспаривать и сопоставлять с источниками.
Метаданные сущностей для агентов
Страницы сущностей содержат универсальные метаданные маршрутизации, применимые к людям, командам, системам, проектам и любым другим типам сущностей:entityType: например,person,team,system,projectcanonicalId: стабильный ключ идентичности для псевдонимов и импортовaliases: имена, дескрипторы или метки, указывающие на одну и ту же страницуprivacyTier: строка свободной формы;publicозначает, что проверка не требуется, любое другое значение (например,local-private,sensitive,confirm-before-use) отмечается вreports/privacy-review.mdbestUsedFor/notEnoughFor: компактные подсказки маршрутизацииlastRefreshedAt: временная метка обновления источника, отдельная от времени редактирования страницыpersonCard: необязательная карточка маршрутизации для человека (дескрипторы, социальные сети, адреса электронной почты, часовой пояс, направление, с какими вопросами обращаться, с какими не обращаться, достоверность, уровень конфиденциальности)relationships: типизированные связи с родственными страницами (цель, тип, вес, достоверность, тип доказательства, уровень конфиденциальности, примечание)
reports/person-agent-directory.md, а затем откройте
страницу человека с помощью wiki_get, прежде чем использовать контактные данные или выведенные
факты.
Пример страницы сущности
Пример страницы сущности
Конвейер компиляции
Компиляция читает страницы вики, нормализует сводки и создаёт стабильные машиночитаемые артефакты в:.openclaw-wiki/cache/agent-digest.json.openclaw-wiki/cache/claims.jsonl
Панели мониторинга и отчёты о состоянии
Когда включёнrender.createDashboards, компиляция поддерживает панели мониторинга в
reports/:
Поиск и извлечение
Два бэкенда поиска:shared: используйте общий процесс поиска в памяти, когда он доступенlocal: выполняйте локальный поиск в вики
wiki, memory, all.
wiki_search/wiki_getпо возможности используют скомпилированные дайджесты на первом этапе- идентификаторы утверждений сопоставляются с содержащей их страницей
- оспариваемые, устаревшие и актуальные утверждения влияют на ранжирование
- метки происхождения данных сохраняются в результатах
--mode / инструмента mode):
Когда результат соответствует структурированному утверждению,
wiki_search возвращает
matchedClaimId, matchedClaimStatus, matchedClaimConfidence,
evidenceKinds и evidenceSourceIds в полезной нагрузке подробных данных. Текстовый вывод
содержит компактные строки Claim: и Evidence:, когда они доступны.
Инструменты агента
Плагин также регистрирует неисключительное дополнение к корпусу памяти, поэтому общие
memory_search и memory_get могут обращаться к вики, если активный плагин
памяти поддерживает выбор корпуса.
Поведение промпта и контекста
Когда включёнcontext.includeCompiledDigestPrompt, разделы промпта памяти
дополняются компактным скомпилированным снимком из agent-digest.json: только основные
страницы, только основные утверждения, количество противоречий, количество вопросов,
уточнения достоверности и актуальности. Эта возможность включается явно, поскольку
изменяет структуру промпта; она важна главным образом для механизмов контекста или
сборки промпта, которые явно используют дополнения памяти.
Конфигурация
Поместите конфигурацию вplugins.entries.memory-wiki.config:
Хранилища для отдельных агентов
Задайте дляvault.scope значение agent, чтобы предоставить каждому настроенному агенту отдельную вики.
В этой области vault.path является родительским каталогом, а OpenClaw добавляет
нормализованный идентификатор агента:
~/.openclaw/wiki/support и
~/.openclaw/wiki/marketing. Если vault.path не указан в области агента,
родительским каталогом по умолчанию становится ~/.openclaw/wiki. Поэтому агент main,
используемый по умолчанию, сохраняет существующий путь ~/.openclaw/wiki/main.
Инструменты агента, скомпилированные сводки промпта и дополнение вики, предоставляемое через
memory_search / memory_get, определяют хранилище из контекста активного агента.
Для вызовов CLI и Gateway в конфигурации с несколькими настроенными агентами явно
укажите агента с помощью openclaw wiki --agent <agentId> ... или поля agentId
запроса Gateway. Если настроен только один агент, он остаётся агентом по умолчанию,
когда идентификатор не указан.
В режиме моста импорт в области агента принимает публичный артефакт памяти, только если
его agentIds включает выбранного агента. Артефакты, принадлежащие другому агенту,
не содержащие метаданных о владельце или имеющие неизвестного владельца, пропускаются.
Глобальная область сохраняет существующее поведение общих артефактов.
Пример: QMD + режим моста
Используйте эту конфигурацию, если хотите применять QMD для извлечения информации, аmemory-wiki — в качестве поддерживаемого слоя знаний. Каждый слой сохраняет
свою специализацию: QMD обеспечивает поиск по необработанным заметкам, экспортам сеансов
и дополнительным коллекциям, а memory-wiki компилирует стабильные сущности,
утверждения, панели мониторинга и страницы источников.
memory-wiki
сосредоточен на скомпилированных страницах и панелях мониторинга, а структура промпта
остаётся неизменной, пока вы намеренно не включите промпты со скомпилированными сводками.
CLI
wiki okf import, wiki apply metadata,
wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback и полный набор
подкоманд wiki obsidian, см. в разделе CLI: вики.
Поддержка Obsidian
Когдаvault.renderMode имеет значение obsidian, плагин записывает
Markdown в формате, совместимом с Obsidian, и при необходимости может использовать
официальный CLI obsidian для проверки состояния, поиска по хранилищу,
открытия страницы, вызова команды и перехода к ежедневной заметке. Это необязательно:
вики продолжает работать в собственном режиме без Obsidian.
Хранилища в области агента также могут использовать Markdown, совместимый с Obsidian,
но проверка конфигурации отклоняет obsidian.useOfficialCli: true вместе с vault.scope: "agent".
Текущая настройка obsidian.vaultName является глобальной и не позволяет выбирать
отдельное хранилище Obsidian для каждого агента. Вместо этого используйте инструменты
вики и операции CLI либо оставьте управляемую через Obsidian вики в глобальной области.
Рекомендуемый рабочий процесс
1
Оставьте активный плагин памяти для извлечения данных
Извлечение, продвижение и Dreaming остаются в ведении настроенного бэкенда памяти.
2
Включите memory-wiki
Начните с режима
isolated, если режим моста не требуется вам явно.3
Используйте wiki_search / wiki_get, когда важно происхождение данных
Предпочитайте их
memory_search, когда нужны специфичное для вики ранжирование или структура убеждений на уровне страниц.4
Используйте wiki_apply для точечного синтеза или обновления метаданных
Не редактируйте управляемые сгенерированные блоки вручную.
5
Запускайте wiki_lint после значимых изменений
Он обнаруживает противоречия, открытые вопросы и пробелы в происхождении данных.
6
Включите панели мониторинга для отслеживания устаревших данных и противоречий
Установите
render.createDashboards: true (по умолчанию).