OpenClaw + Obsidian: как подключить vault и получить AI-агента с памятью
OpenClaw + Obsidian — это связка, которая превращает ваш vault с заметками в живую базу знаний для AI-агента: агент читает, ищет, пишет и обновляет ваши Markdown-файлы прямо внутри рабочего каталога. Настраивается за 15 минут через монтирование vault в ~/.openclaw/workspace и добавление правил в AGENTS.md, без MCP-серверов и сложных интеграций.
Ниже — полный разбор: зачем это нужно, как подключить vault, какие скрипты работают «из коробки» и как не сломать приватность. Статья будет полезна тем, кто уже ведёт второй мозг в Obsidian и хочет, чтобы AI-агент перестал каждый раз переспрашивать «а где у тебя заметки по проекту Х».
🧠 Зачем подключать Obsidian к OpenClaw?
Obsidian хранит ваш опыт, решения и контекст в plain-text Markdown. OpenClaw — это autonomous-агент, который умеет читать файлы, запускать команды и помнить контекст между сессиями. Объединение даёт три эффекта:
- 📚 Постоянная память. Агент не забывает проекты: он видит
life/PARA/Projects/и может обращаться к ним по названию. - 🔍 Семантический поиск. Через pgvector или
ripgrepагент находит нужные заметки за секунды, даже если vault на 5000+ файлов. - ✍️ Двусторонняя работа. Агент не только читает, но и создаёт daily notes, апдейтит
MEMORY.md, добавляет задачи в Inbox.
Главное отличие от «просто RAG» — агент работает с живыми файлами, а не со статичным индексом. Обновили заметку в iPhone → агент уже видит изменения на следующем tick. Это принципиально: классические RAG-пайплайны требуют переиндексации, а при прямом доступе к Markdown всё происходит в один шаг. Плюс вы сохраняете полный контроль: заметки остаются в вашем vault, Git-история не теряется, и ни одна строка не уходит в облако третьих сторон.
Важный момент для тех, кто уже использует Obsidian профессионально: Dataview-запросы, wiki-ссылки [[Заметка]] и YAML-метаданные продолжают работать. Агент читает их как обычный текст и может даже сам добавлять frontmatter при создании новых файлов — если вы опишете схему в AGENTS.md.
⚙️ Как смонтировать vault в workspace OpenClaw?
OpenClaw-агент изолирован в своём workspace (обычно ~/.openclaw/workspace). Чтобы он видел vault, файлы должны быть физически внутри этого каталога. Три рабочих варианта:
| Способ | Плюсы | Минусы |
|---|---|---|
| Git-репо с vault | История, синк между устройствами | Нужен cron на pull |
Симлинк (ln -s) |
Быстро, без дублей | Не работает через bind-mount в Docker |
| Syncthing | Real-time без Git | Лишний демон |
Самый надёжный — Git + автопулл по cron. Это же даёт вам бэкап и синк с iPhone/Mac через GitHub. Команды:
cd ~/.openclaw/workspace
git clone git@github.com:username/obsidian-vault.git life
# Автопулл каждые 10 минут
(crontab -l; echo "*/10 * * * * cd ~/.openclaw/workspace/life && git pull --quiet") | crontab -После этого vault доступен агенту по пути life/PARA/... — как обычные файлы рабочего каталога.
📝 Какие правила добавить в AGENTS.md?
Чтобы агент «понял», что vault — это ваш второй мозг, а не просто папка с мусором, пропишите инструкции. Минимальный блок для AGENTS.md:
## Obsidian Vault
Vault смонтирован в `life/PARA/`. Структура:
- `Projects/` — активные проекты
- `Areas/` — зоны ответственности
- `Resources/` — справочники
- `Archive/` — завершённое
Правила:
- Перед ответом на вопрос о проекте — проверь `life/PARA/Projects/`
- Daily notes создавай в `life/daily/YYYY-MM-DD.md`
- Не трогай `life/private/` — там личные заметки
- При добавлении заметки используй YAML frontmatter: tags, created, updatedЭти 10 строк меняют поведение агента радикально: он перестаёт галлюцинировать контекст и начинает работать с реальными данными.
🔎 Как настроить векторный поиск по vault?
На большом vault (1000+ заметок) grep уже недостаточно — нужна семантика. Самая дешёвая схема: pgvector + Ollama nomic-embed-text. Всё работает локально, токены не тратятся.
- 🐘 Поднимите PostgreSQL с расширением
pgvector(или через Docker:ankane/pgvector). - 🦙 Установите Ollama и модель:
ollama pull nomic-embed-text(768 dims, CPU). - 📜 Положите в
scripts/memory_vector.pyтри функции:save,search,import-file. - ⏰ Cron-задача раз в сутки — индексирует новые файлы по хешам.
- 🔎 Алиас
vmem "запрос"— агент зовёт его перед сложными ответами.
После этого вопрос «а что я писал про LangGraph в марте?» возвращает 3 топ-релевантные заметки за 200 мс — без обращения к внешним API.
🚨 Какие ошибки встречаются чаще всего?
Три частые грабли, на которых спотыкаются в первую неделю:
- ❌ Vault вне workspace. Если примонтировать в
/mnt/obsidian, sandboxed-агент его не увидит. Решение: только внутри~/.openclaw/workspace. - ❌ Приватные заметки в общем контексте. Агент может случайно процитировать личное в Discord-канале. Решение: папка
life/private/+ правило вAGENTS.md«не читать private». - ❌ Конфликты Git при автопулле. Если агент редактирует файл одновременно с синком — merge conflict. Решение:
git stashперед pull или разделить папки: «агентские» и «пользовательские».
✅ Мини-чеклист для запуска
- ✅ Установлен OpenClaw и работает базовый
SOUL.md+AGENTS.md. - ✅ Vault лежит в Git-репозитории (приватном).
- ✅ Репо клонировано в
~/.openclaw/workspace/life. - ✅ Cron на
git pullкаждые 10 минут. - ✅ В
AGENTS.mdдобавлен блок про Obsidian Vault. - ✅ Настроен pgvector или хотя бы
ripgrepдля быстрого поиска. - ✅ Папка
private/защищена правилом в конфиге.
Связка OpenClaw + Obsidian — это не «ещё один AI-помощник», а инструмент, который начинает работать с вашим контекстом, а не поверх него. Поставили один раз — получаете напарника, который помнит всё, что вы когда-либо записали.
❓ FAQ: OpenClaw и Obsidian
1. Нужен ли MCP-сервер для подключения Obsidian к OpenClaw?
Нет. OpenClaw работает с файлами напрямую через свой workspace. MCP нужен, только если вы хотите подключать vault к другим клиентам (Claude Desktop, Cursor). Для самого OpenClaw достаточно смонтировать папку внутрь рабочего каталога.
2. Как синхронизировать vault с iPhone?
Самый простой путь — Obsidian Git plugin + GitHub: коммитите с iPhone, а на сервере cron-pull раз в 10 минут. Альтернатива — Obsidian Sync (платно) + Syncthing на сервер.
3. Может ли агент писать в vault и не сломать мои заметки?
Да, если в AGENTS.md прописаны границы: какие папки можно редактировать, какие — только читать. Плюс Git даёт полную историю: любой неудачный коммит откатывается за секунду.
4. Сколько токенов тратится на работу с vault?
При векторном поиске через Ollama — ноль: эмбеддинги считаются локально. Токены уходят только на итоговый ответ агента, где в контекст попадают 2-3 найденные заметки (обычно 1-3K токенов).
5. Как защитить приватные заметки от утечки в групповых чатах?
Два уровня: (1) папка life/private/ с правилом «не читать» в AGENTS.md; (2) MEMORY.md загружается только в main-сессии, не в Discord/Telegram. OpenClaw поддерживает такое разделение из коробки.
6. Работает ли это с Obsidian Publish или только с локальным vault?
Только с локальным. Obsidian Publish — это read-only веб-версия, агент не сможет её редактировать. Если нужен публичный экспорт — публикуйте выбранные заметки отдельным скриптом.
7. Можно ли использовать эту схему на Mac mini / Raspberry Pi?
Да. OpenClaw работает на любом Linux/macOS с Node 20+. На Mac mini M4 весь стек (OpenClaw + PostgreSQL + Ollama) потребляет ~4 ГБ RAM. На Pi 5 — лучше выносить pgvector на внешний сервер.
Хотите обсудить свою схему интеграции и получать новые гайды по OpenClaw? Присоединяйтесь к Telegram-каналу: t.me/aaakalsin — там разбираем реальные кейсы и делимся рабочими конфигами.