Конфигурация

M.A.V.E.N хранит свою конфигурацию в нескольких известных местах. Все они находятся на вашей машине.

`.env.local`

Учётные данные провайдеров и переключатели времени выполнения, в корне проекта. Файл в gitignore и никогда не включается в релизный zip. Читается только при старте - перезапустите после правки или редактируйте через Настройки → Секреты и ключи, которые пишут тот же файл и применяют изменения сразу.

Задавайте только те ключи, которыми пользуетесь; каждый провайдер включается, когда его ключ присутствует. Наиболее употребимые:

KIMI_API_KEY=            # Kimi engine (platform.moonshot.ai)
ZAI_API_KEY=             # Z.AI GLM engine (set from the Chat account panel)
QWEN_CLOUD_KEY=          # Qwen + DeepSeek on the Alibaba Model Studio plan
OPENAI_API_KEY=          # Codex fallback, infographics
OMNIROUTE_API_KEY=       # OmniRoute gateway
OPENROUTER_API_KEY=      # PROVIDERS - any one of the three is enough
FREEINFERENCE_API_KEY=
TOKENROUTER_API_KEY=
FAL_KEY=                 # image/video engines (Thumbnails, S-Forge, OpenMontage)
KIE_API_KEY=             # second image/video provider
MAGNIFIC_API_KEY=        # X-Forge
SUNO_API_KEY=            # M-Forge → Music
ELEVENLABS_API_KEY=      # paid narration / dubbing (free Supertonic needs nothing)
GEMINI_API_KEY=          # Google TTS / infographics
TAVILY_API_KEY=          # R-Forge, N-Forge web search, Ad Scout
FIRECRAWL_API_KEY=
MESHY_API_KEY=           # G-Forge (test mode without it)
HF_TOKEN=                # M-Forge cloud watermark removal
GITHUB_MAVEN_UPDATE=     # read token for the in-app updater (private repo)

Claude, Grok, Codex, Antigravity, Qwen Code, Hermes, OpenClaw, OpenCode, Ollama и Open Design здесь ключа не требуют - каждый использует собственный логин.

Пути

MAVEN_VAULT_DIR - папка Obsidian, куда дописываются чаты, цели и записи журнала, по одному markdown-файлу в день. Укажите любую доступную для записи папку, если не пользуетесь Obsidian. Корень хранилища (vault) - её родитель: по умолчанию ~/Obsidian/maven-os, с Memories/, Notebooks/, Pipeline/, Room/ и одной папкой на каждое приложение Forge.
MAVEN_VAULT_BROWSE_ROOT - то, что читает приложение Память (поиск + граф) по всем вашим хранилищам; по умолчанию ~/Obsidian. Только чтение.
~/.maven - состояние времени выполнения, создаётся автоматически и никогда не поставляется: settings.json (глобальная модель, настройки приложений), история chat/, логи jobs/, движки и venv отдельных приложений, PIN удалённого доступа, учёт обновлений.

`agents.config.json`

Флот CLI-агентов: одна запись на агента (id, name, command, args с {prompt}, цвет, глиф, подключение навыков). Перечитывается при обновлении страницы - без перезапуска - и обновлятор никогда его не перезаписывает. Любой новый CLI-агент получает пикер skills.sh (skillsShAgent + skillsDir); исключение - Hermes, который использует собственный реестр.

Настройки

Шестерёнка в подвале боковой панели открывает Настройки - левая рейка плюс поиск:

Обновления - проверить сейчас, два ежедневных часа проверки, автообновление вкл/выкл. См. Обновление.
Маршрутизация моделей - пропускать провайдеров, которые только что упали и переключаться на другую модель, обе по умолчанию выключены.
Секреты и ключи - каждый ключ, замаскированный; добавляйте, меняйте или удаляйте, не трогая файл.
Безопасность - PIN удалённого доступа, разрешённые хосты и дневной потолок расходов. См. Безопасность и удалённый доступ.
Внешний вид - тема (Black / Navy), звук, язык (EN / UK / RU).
Модели / Агенты / Forge / Self - карточки-переключатели, показывающие или скрывающие любой пункт боковой панели, с Скрыть все / Показать все для каждого раздела. Скрытие приложения убирает его из боковой панели, флота на Дашборде и радара; ничего при этом не останавливается.

Чисто визуальные предпочтения живут в localStorage; всё остальное - в ~/.maven/settings.json.

Менеджер моделей

Кнопка Модели в верхней панели перечисляет каждое семейство моделей, до которого может дотянуться эта установка, сколько каждое стоит, и переключатель, выключающий любое семейство или отдельную модель везде. Каждый пикер в каждом приложении - ряд движков в Чате, бокс глобальной модели, пикеры Forge, состав Мастермайнда - фильтруется через него. Сам менеджер никогда не фильтруется, так что вы всегда можете включить что-то обратно. См. Менеджер моделей.

`next.config.ts` - разрешённые dev-origin

Dev-режим Next отказывается отдавать свои ресурсы /_next/* любому origin, кроме localhost. Список заранее заполнен 127.0.0.1, localhost, именем хоста, IP в локальной сети и *.local. Если вы обращаетесь к dev-серверу другим способом, добавьте этот хост в allowedDevOrigins и перезапустите - иначе страницы загружаются пустыми. (Удалённым хостам также нужен шлюз безопасности - см. Безопасность.)