openclaw wiki
Проверяйте и обслуживайте хранилище memory-wiki. Предоставляется встроенным плагином memory-wiki.
См. также: плагин Memory Wiki, обзор памяти, CLI: память
Основные команды
Выбор агента
Когдаplugins.entries.memory-wiki.config.vault.scope имеет значение agent, выберите
хранилище с помощью глобального параметра --agent <id>:
--agent,
чтобы команда не могла читать или записывать произвольное хранилище по умолчанию. Если
настроен только один агент, он остаётся агентом по умолчанию. Неизвестные идентификаторы агентов
вызывают ошибку до начала операции с хранилищем. Этот параметр не изменяет выбранный
путь, когда vault.scope имеет значение global.
Для клиентов Gateway действует то же правило: передавайте agentId в запросах wiki.*,
работающих с хранилищем, при конфигурации с несколькими агентами и областью действия агента. Отсутствующий или неизвестный идентификатор
считается ошибкой. Ходы агента, инструменты вики, дополнения к корпусу памяти и скомпилированные
дайджесты промптов уже содержат контекст активного агента среды выполнения.
Команды
wiki status
Показывает режим и область действия хранилища, определённого агента, состояние и доступность CLI Obsidian. Используйте эту команду первой, чтобы проверить, инициализировано ли нужное хранилище, исправен ли режим моста и доступна ли интеграция с Obsidian.
Когда режим моста активен и настроен на чтение артефактов памяти, эта команда обращается к работающему Gateway, поэтому видит тот же контекст активного плагина памяти, что и память агента или среды выполнения.
wiki doctor
Запускает проверки состояния вики и сообщает о возможных исправлениях. При обнаружении проблем завершается с ненулевым кодом.
Когда режим моста активен и настроен на чтение артефактов памяти, эта команда обращается к работающему Gateway перед формированием отчёта. Отключённый импорт через мост и конфигурации моста, не читающие артефакты памяти, работают локально и автономно.
Типичные проблемы:
- режим моста включён без общедоступных артефактов памяти
- недопустимая или отсутствующая структура хранилища
- отсутствует внешний CLI Obsidian, когда ожидается режим Obsidian
wiki init
Создаёт структуру хранилища вики и начальные страницы, включая индексы верхнего уровня и каталоги кеша.
wiki ingest <path>
Импортирует локальный файл Markdown или текстовый файл в папку sources/ вики в качестве исходной страницы. <path> должен быть путём к локальному файлу; импорт по URL сейчас не поддерживается. Двоичные файлы отклоняются.
Импортированные исходные страницы содержат frontmatter с данными о происхождении (sourceType: local-file, sourcePath, ingestedAt). После импорта хранилище всегда компилируется заново.
Флаги: --title <title> переопределяет заголовок источника (по умолчанию он формируется из имени файла).
wiki okf import <path>
Импортирует распакованный пакет Open Knowledge Format в страницы концепций вики.
Импортёр читает каждый незарезервированный документ концепции .md в дереве каталогов OKF, требует непустое поле type и обрабатывает неизвестные значения OKF type как универсальные концепции. Зарезервированные файлы OKF index.md и log.md не импортируются как концепции.
Импортированные страницы размещаются в плоской структуре внутри concepts/, поэтому существующие процессы компиляции, поиска, чтения, создания дайджестов и панелей вики сразу их видят. Исходный идентификатор концепции OKF, type, resource, tags, временная метка, путь к источнику и полный frontmatter сохраняются во frontmatter страницы. Внутренние ссылки Markdown из OKF переписываются так, чтобы указывать на созданные страницы вики; неработающие и внешние ссылки остаются без изменений. После импорта хранилище всегда компилируется заново.
Примеры:
wiki compile
Перестраивает индексы, блоки связанных материалов, панели и скомпилированные дайджесты. Записывает стабильные машиночитаемые артефакты в:
.openclaw-wiki/cache/agent-digest.json.openclaw-wiki/cache/claims.jsonl
render.createDashboards, компиляция также обновляет страницы отчётов.
wiki lint
Проверяет хранилище и записывает отчёт, охватывающий:
- структурные проблемы (неработающие ссылки, отсутствующие или повторяющиеся идентификаторы, отсутствующий тип страницы или заголовок, недопустимый frontmatter)
- пробелы в данных о происхождении (отсутствующие идентификаторы источников, отсутствующие данные о происхождении импорта)
- противоречия (отмеченные противоречия, конфликтующие утверждения)
- открытые вопросы
- страницы и утверждения с низкой степенью уверенности
- устаревшие страницы и утверждения
wiki search <query>
Выполняет поиск по содержимому вики. Поведение зависит от конфигурации:
search.backend:sharedилиlocalsearch.corpus:wiki,memoryилиall--mode:auto,find-person,route-question,source-evidenceилиraw-claim
wiki search для ранжирования и отслеживания происхождения с учётом особенностей вики. Для одного широкого прохода поиска по общей памяти предпочитайте openclaw memory search, когда активный плагин памяти предоставляет общий поиск.
Режимы поиска:
find-person: псевдонимы, имена пользователей, учётные записи в социальных сетях, канонические идентификаторы и страницы людейroute-question: подсказки о том, к кому обращаться и для чего лучше использовать, а также контекст отношенийsource-evidence: исходные страницы и структурированные поля доказательствraw-claim: текст структурированных утверждений с метаданными утверждений и доказательств
Claim: и Evidence:, когда результат соответствует структурированному утверждению. Вывод JSON дополнительно предоставляет matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds и evidenceSourceIds для подробного изучения на стороне агента.
wiki get <lookup>
Читает страницу вики по идентификатору или относительному пути.
wiki apply
Применяет ограниченные изменения без произвольного редактирования страниц:
apply synthesis <title>: создаёт или обновляет страницу синтеза с управляемым текстом сводкиapply metadata <lookup>: обновляет метаданные существующей страницы
--source-id, --contradiction, --question (каждый можно указывать несколько раз), --confidence <n> (0-1) и --status <status>. apply metadata также принимает --clear-confidence, чтобы удалить сохранённое значение уверенности. Это поддерживаемый способ развития страниц вики, при котором управляемые сгенерированные блоки остаются неизменными.
wiki bridge import
Импортирует общедоступные артефакты памяти из активного плагина памяти в исходные страницы на основе моста. Используйте эту команду в режиме bridge, чтобы загрузить последние экспортированные артефакты памяти в хранилище вики.
Для активного чтения артефактов через мост CLI направляет импорт через RPC Gateway, чтобы использовать контекст плагина памяти среды выполнения. Если импорт через мост отключён или чтение артефактов выключено, команда сохраняет локальное и автономное поведение с нулевым импортом. Обновление индекса после импорта контролируется параметром ingest.autoCompile.
wiki unsafe-local import
Импортирует данные из явно настроенных локальных путей (unsafeLocal.paths) в режиме unsafe-local. Эта возможность намеренно является экспериментальной и работает только на одном компьютере. Обновление индекса после импорта контролируется параметром ingest.autoCompile.
wiki chatgpt import
Импортирует экспорт ChatGPT в черновые исходные страницы вики.
Если импорт без пробного режима изменяет какие-либо страницы, он регистрирует идентификатор запуска импорта, выводимый в сводке и необходимый для отката.
wiki chatgpt rollback <run-id>
Откатывает ранее применённый запуск импорта ChatGPT: удаляет созданные им страницы и восстанавливает перезаписанные. Ничего не делает (и сообщает alreadyRolledBack), если запуск уже был отменён.
wiki obsidian ...
Вспомогательные команды Obsidian для хранилищ, работающих в режиме совместимости с Obsidian: status, search, open, command, daily. Когда включён obsidian.useOfficialCli, для них требуется официальный CLI obsidian в PATH.
Проверка конфигурации отклоняет obsidian.useOfficialCli: true, когда
vault.scope имеет значение agent, поскольку obsidian.vaultName — это одна глобальная настройка,
а не сопоставление для каждого агента. Отображение Markdown в формате, совместимом с Obsidian, остаётся
доступным.
Практические рекомендации по использованию
- Используйте
wiki search+wiki get, когда важны происхождение и идентичность страницы. - Используйте
wiki applyвместо ручного редактирования управляемых сгенерированных разделов. - Используйте
wiki lint, прежде чем доверять противоречивому содержимому или содержимому с низкой степенью уверенности. - Используйте
wiki compileпосле массового импорта или изменения источников, если хотите сразу получить обновлённые панели и скомпилированные дайджесты. - Используйте
wiki okf import, когда каталог данных, экспорт документации или конвейер обогащения агента уже создаёт пакеты Markdown в формате OKF. - Используйте
wiki bridge import, когда режим моста зависит от недавно экспортированных артефактов памяти.
Связь с конфигурацией
Поведениеopenclaw wiki определяется следующими параметрами:
plugins.entries.memory-wiki.config.vaultModeplugins.entries.memory-wiki.config.vault.scopeplugins.entries.memory-wiki.config.vault.pathplugins.entries.memory-wiki.config.search.backendplugins.entries.memory-wiki.config.search.corpusplugins.entries.memory-wiki.config.bridge.*plugins.entries.memory-wiki.config.obsidian.*plugins.entries.memory-wiki.config.ingest.autoCompileplugins.entries.memory-wiki.config.render.*plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt