Часто задаваемые вопросы по API-ключам
Вопрос: Что делать, если API-ключ внезапно перестал работать и модель не вызывается?
API-ключ OpenClaw может стать недействительным из-за истечения срока, ручного отзыва или срабатывания ограничений безопасности. Сначала войдите в консоль OpenClaw и проверьте статус ключа на странице «API Keys». Если отображается «Inactive», создайте новый ключ и замените им старый. Обратите внимание: на один аккаунт можно создать не более 5 активных ключей — при частой ротации не забывайте удалять старые неиспользуемые ключи.
Вопрос: Как диагностировать ошибку 401 при вызове API?
Ошибка 401 означает сбой аутентификации. Убедитесь, что в заголовке запроса поле «Authorization» имеет формат «Bearer <ваш_api_ключ>» и что в ключе нет лишних пробелов. Если ключ хранится в переменной окружения, проверьте правильность написания имени переменной. Кроме того, ключи бесплатных пробных аккаунтов могут автоматически отключаться после окончания пробного периода — для продолжения работы необходимо перейти на платный тариф.
Вопросы оплаты и выставления счетов
Вопрос: Почему сумма в счёте превысила мои ожидания?
OpenClaw тарифицируется по количеству токенов, и стоимость различается в зависимости от модели. Превышение ожиданий может быть связано с: 1) использованием высокоточной модели (например, Claw-4) без учёта её цены; 2) включением в запрос большого объёма системных подсказок или истории диалога, что приводит к высокому фактическому расходу токенов. Рекомендуется устанавливать лимит «max_tokens» в API-запросах и просматривать детализацию расхода за день/час на странице «Usage» в консоли. Если вы заметили аномальные пики, проверьте код на наличие циклических ошибок.
Вопрос: Как получить налоговый счёт после оформления подписки?
В разделе «Billing» настроек аккаунта OpenClaw нажмите «Invoice History» и выберите запись, на которую нужно выставить счёт. Вы можете указать название компании, ИНН и юридический адрес. Учтите: для личных аккаунтов доступны только счета на физическое лицо, после верификации компании можно оформить корпоративный счёт. Обычно счёт отправляется на зарегистрированную электронную почту в течение 3–5 рабочих дней после запроса.
Безопасность аккаунта и управление доступом
Вопрос: Как предотвратить несанкционированное использование моего API-ключа?
OpenClaw предлагает функцию «Белый список IP-адресов» — в разделе «Security» вы можете задать диапазон IP, с которых разрешены вызовы API. Если вы не знаете свой IP, используйте механизм «временных ключей» с ограниченным сроком действия (например, 1 час). Кроме того, не рекомендуется встраивать API-ключ непосредственно в клиентский код — лучше применять прокси-сервер на бэкенде. Регулярно проверяйте «API Logs» в консоли, чтобы выявить подозрительные источники вызовов.
Вопрос: Как разблокировать аккаунт, если он был заблокирован?
Блокировка аккаунта обычно происходит из-за многократных неудачных попыток входа или превышения лимита частоты API-запросов. Попробуйте следующие шаги: 1) подождите 15–30 минут для автоматической разблокировки (кратковременная блокировка); 2) сбросьте пароль и войдите снова; 3) если отображается статус «Suspended», обратитесь в службу поддержки OpenClaw, указав зарегистрированный email и описав ситуацию. Обратите внимание: нарушение условий использования (например, массовая регистрация, злонамеренный парсинг) может привести к постоянной блокировке без возможности апелляции.
