Obsidian + AI: как подключить нейросети к заметкам через плагины
Вступление
Obsidian — это редактор заметок, в котором всё хранится в локальных Markdown-файлах. Искусственный интеллект подключается к нему через плагины — например, Text Generator, Copilot for Obsidian и Smart Connections. Все они умеют работать с OpenAI-совместимым API, поэтому вместо официального OpenAI можно подключить любой совместимый сервис, включая TokenMaster.
Что понадобится
- Установленный Obsidian (Windows, macOS или Linux).
- Любой AI-плагин: Text Generator, Copilot for Obsidian или Smart Connections.
- Ключ API от OpenAI-совместимого провайдера — мы используем TokenMaster.
Сами нейросети работают на стороне провайдера, поэтому Obsidian можно ставить даже на слабую машину: тяжёлых вычислений на вашем компьютере не происходит.
Установка Obsidian
Самый простой способ для любой системы — скачать установщик с официального сайта obsidian.md и запустить его.
- Windows: загрузите
.exe-установщик с официального сайта и следуйте шагам мастера. - macOS: скачайте
.dmgи перетащите Obsidian в «Программы», либо установите через Homebrew:brew install --cask obsidian. - Linux: доступны AppImage,
.deb-пакет, а также Snap (snap install obsidian) и Flatpak (flatpak install flathub md.obsidian.Obsidian).
После установки создайте «хранилище» (vault) — папку, в которой будут лежать ваши заметки. При первом запуске Obsidian предложит создать новое хранилище или открыть существующую папку: просто укажите удобное место на диске.
Установка и настройка AI-плагина
Разберём на примере Copilot for Obsidian.
- Откройте Настройки → Сторонние плагины и отключите «Безопасный режим».
- Нажмите «Обзор» и найдите «Copilot for Obsidian», затем установите и включите плагин.
- Перейдите в настройки плагина и найдите раздел провайдера модели. Выберите вариант Custom (пользовательский) или OpenAI-compatible, чтобы указать собственный адрес API.
- В поле Base URL вставьте адрес совместимого API, в поле API Key — ваш ключ. При необходимости укажите название модели (например,
deepseek-flash,glm-4.5илиqwen3.8-max).
У Copilot for Obsidian после настройки появляется чат-панель и режим ответов по вашим заметкам. У Text Generator и Smart Connections настройка аналогичная: в параметрах провайдера выбирается пользовательский OpenAI-совместимый эндпоинт, после чего задаются Base URL, ключ и модель. Названия полей могут немного отличаться, но суть одна: адрес API, ключ и модель.
Подключение TokenMaster
- Зарегистрируйтесь на tokenmaster.ru и создайте ключ в разделе «Ключи».
- Вернитесь в настройки плагина и укажите:
- Base URL:
https://tokenmaster.ru/v1 - API Key: ваш ключ вида
sk-…
- Base URL:
- Сохраните настройки и выберите модель.
TokenMaster — это OpenAI-совместимый API-шлюз: один ключ и общий баланс для моделей DeepSeek, GLM (Zhipu) и Qwen, с оплатой из России. Названия моделей можно посмотреть в личном кабинете или документации. Тарифы смотрите на tokenmaster.ru/pricing, документацию — на tokenmaster.ru/docs.
Проверка работы
Откройте любую заметку и запустите команду плагина (например, чат или генерацию текста). Для проверки достаточно простого запроса вроде «Напиши краткий конспект этой заметки». Если ответ пришёл — всё настроено верно.
Типовые ошибки:
- 401 Unauthorized — неверный или недействительный ключ API. Проверьте, что ключ скопирован целиком, без пробелов и обрывов.
- Connection error / failed to fetch — неверный Base URL или нет доступа к сети. Должно быть
https://tokenmaster.ru/v1без лишних слэшей. - Insufficient quota — на балансе нет средств. Пополните баланс в личном кабинете TokenMaster.
Частые вопросы
Какие модели доступны через TokenMaster? DeepSeek, GLM (Zhipu) и Qwen. Все они работают через один ключ и общий баланс.
Подойдут ли другие плагины Obsidian? Да. Любой плагин с поддержкой OpenAI-совместимого API или настраиваемого Base URL будет работать с TokenMaster — это касается не только Text Generator и Smart Connections, но и других плагинов для генерации текста и диалога с заметками.
Можно ли использовать мобильный Obsidian? Можно, но настройка плагинов на мобильных устройствах ограничена — удобнее настраивать на компьютере, а заметки синхронизировать через хранилище.
Итог
Подключить нейросети к Obsidian просто: установите плагин, укажите OpenAI-совместимый провайдер и вставьте Base URL https://tokenmaster.ru/v1 вместе с ключом sk-…. После этого все ваши заметки получат доступ к моделям DeepSeek, GLM и Qwen через один аккаунт.