Добавить API-ключ
Ничему в M.A.V.E.N не нужен ключ, чтобы запуститься. Каждый провайдер включается, когда его ключ присутствует, и остаётся выключенным - наглядно, с указанием переменной, которую он ждёт, - когда ключа нет. Это руководство добавляет один ключ и проверяет его на примере Kimi.
1. Получите ключ
Заголовок раздела «1. Получите ключ»Создайте ключ в консоли провайдера - для Kimi это platform.moonshot.ai/console. Каждая страница приложения в этих доках называет свою переменную и место, где взять ключ, в разделе Что ему нужно; полный список - на странице Конфигурация.
2. Добавьте его в Настройки → Секреты и ключи
Заголовок раздела «2. Добавьте его в Настройки → Секреты и ключи»Откройте шестерёнку в подвале боковой панели → Секреты и ключи. Найдите KIMI_API_KEY,
вставьте значение, сохраните. Панель сама записывает .env.local и применяет изменение
сразу; с этого момента значение показывается замаскированным, и позже вы можете здесь же
заменить или удалить его.
Предпочитаете файл? Отредактируйте .env.local в папке установки:
KIMI_API_KEY=sk-...Затем перезапустите - файл читается только при старте (systemctl --user restart maven
или остановите и запустите npm run dev).
3. Проверьте, что он загорелся
Заголовок раздела «3. Проверьте, что он загорелся»- Точка в боковой панели рядом с Kimi включается и показывает Moonshot K2 API.
- В Чате движок Kimi больше не затенён.
- Health показывает провайдера как OK.
Если он остаётся выключенным: проверьте имя переменной (затенённый движок его печатает), что нет лишней кавычки или пробела, и что вы перезапустились после правки файла.
Ключи, которые не ключи
Заголовок раздела «Ключи, которые не ключи»Claude, Grok, Codex, Antigravity, Qwen Code, Hermes, OpenClaw, OpenCode и Ollama используют
собственные логины - один раз запустите CLI в терминале (или claude setup-token на
безголовом сервере), и M.A.V.E.N найдёт его в PATH. Z.AI вставляется из панели аккаунта в Чате,
которая проверяет ключ перед тем, как сохранить его как ZAI_API_KEY.
Куда ключу разрешено уходить
Заголовок раздела «Куда ключу разрешено уходить»Ключи остаются на этой машине: .env.local имеет права 0600, никогда не попадает в
релизный zip и никогда не доходит до браузера. Агенты, запущенные M.A.V.E.N, получают только
те переменные, которые им нужны. См. Безопасность и удалённый доступ.
См. также
Заголовок раздела «См. также»- Секреты и ключи
- Менеджер моделей - как выключить семейство везде, не удаляя его ключ.