Технический справочник

Использование API и расходы

В этом документе перечислены функции, которые могут использовать API-ключи, и указано, где отображаются связанные с ними расходы. Основное внимание уделяется функциям OpenClaw, которые могут генерировать использование услуг провайдера или платные вызовы API.

Где отображаются расходы (чат + CLI)

Снимок стоимости за сессию

  • /status показывает текущую модель сессии, использование контекста и количество токенов в последнем ответе.
  • Если модель использует аутентификацию по API-ключу, /status также показывает предполагаемую стоимость последнего ответа.

Сноска о стоимости для каждого сообщения

  • /usage full добавляет сноску об использовании к каждому ответу, включая предполагаемую стоимость (только для API-ключа).
  • /usage tokens показывает только токены; для OAuth-потоков стоимость в долларах скрыта.

Окна использования в CLI (квоты провайдера)

  • openclaw status --usage и openclaw channels list показывают окна использования провайдера (снимки квот, а не стоимость за сообщение).

Подробности и примеры см. в разделе Использование токенов и стоимость.

Как обнаруживаются ключи

OpenClaw может получать учетные данные из:

  • Профилей аутентификации (для каждого агента, хранятся в auth-profiles.json).
  • Переменных окружения (например, OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
  • Конфигурации (models.providers.*.apiKey, tools.web.search.*, tools.web.fetch.firecrawl.*, memorySearch.*, talk.apiKey).
  • Навыков (skills.entries.<name>.apiKey), которые могут экспортировать ключи в окружение процесса навыка.

Функции, которые могут тратить ключи

1) Основные ответы модели (чат + инструменты)

Каждый ответ или вызов инструмента использует текущего провайдера модели (OpenAI, Anthropic и т.д.). Это основной источник использования и расходов. См. Модели для конфигурации цен и Использование токенов и стоимость для отображения.

2) Понимание медиа (аудио/изображение/видео)

Входящие медиафайлы могут быть суммированы/расшифрованы до формирования ответа. Для этого используются API модели/провайдера.

  • Аудио: OpenAI / Groq / Deepgram (теперь автоматически включается при наличии ключей).
  • Изображение: OpenAI / Anthropic / Google.
  • Видео: Google.

См. Понимание медиа.

3) Эмбеддинги памяти + семантический поиск

Семантический поиск по памяти использует API эмбеддингов при настройке на удаленных провайдеров:

  • memorySearch.provider = "openai" → эмбеддинги OpenAI
  • memorySearch.provider = "gemini" → эмбеддинги Gemini
  • memorySearch.provider = "voyage" → эмбеддинги Voyage
  • memorySearch.provider = "mistral" → эмбеддинги Mistral
  • memorySearch.provider = "ollama" → эмбеддинги Ollama (локальные/самостоятельно размещенные; обычно без биллинга за хостинг API)
  • Опциональный резервный провайдер, если локальные эмбеддинги не сработали

Вы можете оставить его локальным с memorySearch.provider = "local" (без использования API). См. Память.

4) Инструмент веб-поиска

web_search использует API-ключи и может влечь расходы в зависимости от вашего провайдера:

  • Perplexity Search API: PERPLEXITY_API_KEY
  • Brave Search API: BRAVE_API_KEY или tools.web.search.apiKey
  • Gemini (Google Search): GEMINI_API_KEY
  • Grok (xAI): XAI_API_KEY
  • Kimi (Moonshot): KIMI_API_KEY или MOONSHOT_API_KEY

См. Веб-инструменты.

5) Инструмент получения веб-страниц (Firecrawl)

web_fetch может вызывать Firecrawl при наличии API-ключа:

  • FIRECRAWL_API_KEY или tools.web.fetch.firecrawl.apiKey

Если Firecrawl не настроен, инструмент переходит на прямое получение + readability (без платного API). См. Веб-инструменты.

6) Снимки использования провайдера (статус/здоровье)

Некоторые команды статуса вызывают эндпоинты использования провайдера для отображения окон квот или состояния аутентификации. Обычно это низкочастотные вызовы, но они все равно обращаются к API провайдера:

  • openclaw status --usage
  • openclaw models status --json

См. CLI моделей.

7) Суммаризация для защиты от компактизации

Защита от компактизации может суммировать историю сессии с использованием текущей модели, что приводит к вызовам API провайдера при ее срабатывании. См. Управление сессией + компактизация.

8) Сканирование / проверка моделей

openclaw models scan может проверять модели OpenRouter и использует OPENROUTER_API_KEY, когда проверка включена. См. CLI моделей.

9) Речь (озвучка)

Режим речи может использовать ElevenLabs при настройке:

  • ELEVENLABS_API_KEY или talk.apiKey

См. Режим речи.

10) Навыки (сторонние API)

Навыки могут хранить apiKey в skills.entries.<name>.apiKey. Если навык использует этот ключ для внешних API, это может повлечь расходы согласно тарифам провайдера навыка. См. Навыки.

Кэширование промптовГигиена транскрипта