Решение проблем

Troubleshooting

Команда iola не найдена

Проверьте глобальную установку:

npm install -g @iola_adm/iola-cli
npm bin -g

Нужна новая версия Node.js

node --version
iola init --upgrade-node

Ollama недоступна

ollama --version
ollama serve
iola ai doctor

YandexGPT/GigaChat/OpenAI/OpenRouter key не найден

iola ai key status
iola yandex cloud setup
iola ai key set gigachat
iola ai key set openai
iola ai key set openrouter

Где получить ключ:

• YandexGPT: https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication
• GigaChat: https://developers.sber.ru/docs/ru/gigachat/overview
• OpenAI Platform: https://platform.openai.com/api-keys
• OpenRouter: https://openrouter.ai/settings/keys

Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Рекомендуемый путь - iola yandex cloud setup, там же подключается ключ геокодера для geo-skills и Яндекс Go deeplink. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.

Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Если API-запросы не проходят после сохранения ключа, проверьте не только ключ, но и billing/баланс в личном кабинете сервиса.

Нет локальных данных

iola sync
iola sync status
iola search "школа" --local

Нужен подробный лог

iola --debug --debug-file iola-debug.log doctor