wiki/entities/project-wiki-memory.md

pageType, id, title, entityType, status, updatedAt, sourceIds, tags

pageType	id	title	entityType	status	updatedAt	sourceIds	tags
entity	entity.project-wiki-memory	Wiki & Memory	Project	active	2026-04-10T13:48:00.000Z	source.memory	project wiki memory qmd setup

Wiki & Memory

Ключевые факты

• Дата настройки: 10 апреля 2026
• Статус: active
• Папка: tasks/wiki-memory/

Описание

Комплексная настройка системы памяти OpenClaw: замена встроенного SQLite на QMD sidecar + инициализация Memory Wiki vault с entities/concepts для всех проектов и скиллов.

---

Архитектура системы памяти

Схема работы

Файлы workspace/          QMD sidecar (Gemma-300M)     Агент
───────────────────       ────────────────────────     ──────
MEMORY.md                 memory-root-main (159 docs)  memory_search
memory/YYYY-MM-DD.md  →   memory-dir-main  (33 docs)   → BM25 + vector
tasks/**/*.md             tasks-main       (104 docs)     reranking
skills/**/*.md            skills-main      (10 docs)   ↓
agents/main/sessions/     sessions-main    (111 docs)  релевантные чанки

Wiki vault                              Агент (каждый запрос)
─────────────────────                  ──────────────────────
sources/   (ingest файлов)             includeCompiledDigestPrompt: true
entities/  (проекты, люди)    →  →  →  agent-digest.json → системный промпт
concepts/  (скиллы, правила)           wiki_search / wiki_get (по запросу)
syntheses/
reports/   (lint, health)

Два независимых слоя памяти

Слой	Инструмент	Для чего
QMD	memory_search	Полнотекстовый + семантический поиск по всем файлам
Wiki	wiki_search, digest в промпте	Структурированные знания: entities, concepts

---

QMD Backend

Конфигурация (openclaw.json, корневой ключ memory)

{
  "memory": {
    "backend": "qmd",
    "qmd": {
      "command": "/home/node/.local/bin/qmd",
      "paths": [
        { "name": "tasks", "path": "~/.openclaw/workspace/tasks", "pattern": "**/*.md" },
        { "name": "skills", "path": "~/.openclaw/workspace/skills", "pattern": "**/*.md" }
      ],
      "sessions": { "enabled": true }
    }
  }
}

Коллекции (main агент)

Коллекция	Документов
memory-root-main (workspace/)	159
sessions-main (транскрипты)	111
tasks-main (workspace/tasks/)	104
memory-dir-main (workspace/memory/)	33
skills-main (workspace/skills/)	10
Итого	417 документов

Эмбеддинги

• Модель: embeddinggemma-300M-Q8_0.gguf (~328MB)
• Только CPU → индексация ~30-60 мин на 400+ чанков
• После завершения: Vector: ready автоматически
• Все агенты (main, dev, legal, feda): Vector ready ✅

Известная проблема: memory-alt-main

QMD создаёт memory-root-main с **/*.md, OpenClaw ищет memory-alt-main.

Фикс:

# ~/.openclaw/agents/main/qmd/xdg-config/qmd/index.yml
memory-alt-main:
  path: /home/node/.openclaw/workspace
  pattern: "memory.md"

Затем: rm ~/.openclaw/agents/main/qmd/xdg-cache/qmd/index.sqlite* && openclaw memory index --force

---

Memory Wiki

Конфигурация (openclaw.json)

// plugins.entries.memory-wiki.config:
{
  "bridge": { "enabled": true, "readMemoryArtifacts": true, ... },
  "context": { "includeCompiledDigestPrompt": true }
}

// agents.list[main].tools.allow:
["wiki_status", "wiki_search", "wiki_get", "wiki_apply", "wiki_lint"]

Bridge mode — не работает (known limitation)

OpenClaw использует jiti vm-контексты для изоляции плагинов. memory-core и memory-wiki загружаются в разных контекстах → memoryPluginState разные объекты → capability не видна.

openclaw wiki bridge import всегда возвращает 0 артефактов. Это архитектурная проблема версии 2026.4.9, не баг конфига. Workaround: ручной ingest.

Как пополнять wiki (рабочий процесс)

# 1. Добавить источник
openclaw wiki ingest ~/.openclaw/workspace/MEMORY.md
openclaw wiki ingest ~/.openclaw/workspace/tasks/*/PROJECT.md

# 2. Создать entity/concept страницу (wiki_apply или вручную в vault)
# Файл: ~/.openclaw/wiki/main/entities/project-xxx.md

# 3. Скомпилировать и проверить
openclaw wiki compile
openclaw wiki lint

Текущий vault (10.04.2026)

• Vault: /home/node/.openclaw/wiki/main
• Режим: bridge (формально), фактически manual ingest
• Страниц: 27 (9 entities, 5 concepts, 7 sources, 6 reports)
• Lint: 0 issues ✅

Entities (проекты)

• Snowbike RAG, Telegram Collector, Карта шумового загрязнения FR24
• Интернет-заказы, Home Assistant, Proxy VM, Tapo Camera Monitor
• Apps Portal, Видеокружочки

Concepts (скиллы)

• voice-tts, telegram-collector, ontology, diagram-png/table, youtube/yandex-search

---

Задачи

✅ Первичная настройка (done, 10.04.2026)

• Установка QMD, настройка коллекций, эмбеддинги
• Инициализация wiki vault, добавление wiki_* инструментов
• Ingest ключевых файлов (MEMORY.md, PROJECT.md × 6, SKILL.md × 9)
• Создание 9 entities + 5 concepts
• Синхронизация с онтологией

Открытые вопросы

• Bridge mode: ждём фикса в OpenClaw (jiti-изоляция плагинов)
• Wiki не обновляется автоматически — нужен ручной ingest + compile при изменениях
• Dreaming отключён (можно включить для ночной синтез-генерации)

Related

Sources

• MEMORY