Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Де відображаються витрати (чат + CLI)

Знімок вартості за сесію
  • /status показує поточну модель сесії, використання контексту та токени останньої відповіді.
  • Якщо модель використовує автентифікацію API-ключем, /status також показує орієнтовну вартість останньої відповіді.
  • Якщо live-метадані сесії неповні, /status може відновити лічильники токенів/кешу і мітку активної runtime-моделі з останнього запису використання в транскрипті. Наявні ненульові live-значення все ще мають пріоритет, а підсумки транскрипта розміру prompt можуть переважати, коли збережені підсумки відсутні або менші.
Футер вартості для кожного повідомлення
  • /usage full додає футер використання до кожної відповіді, включно з орієнтовною вартістю (лише API-ключ).
  • /usage tokens показує лише токени; OAuth/token у стилі підписки та CLI-потоки приховують вартість у доларах.
  • Примітка щодо Gemini CLI: коли CLI повертає JSON-вивід, OpenClaw читає використання зі stats, нормалізує stats.cached у cacheRead і за потреби виводить вхідні токени з stats.input_tokens - stats.cached.
Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw розглядає повторне використання Claude CLI і використання claude -p як санкціоновані для цієї інтеграції, якщо Anthropic не опублікує нову політику. Anthropic досі не надає оцінку вартості в доларах для кожного повідомлення, яку OpenClaw може показати в /usage full. Вікна використання CLI (квоти провайдерів)
  • openclaw status --usage і openclaw channels list показують вікна використання провайдера (знімки квот, а не вартість окремих повідомлень).
  • Людський вивід нормалізується до X% left для різних провайдерів.
  • Поточні провайдери вікон використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi і z.ai.
  • Примітка щодо MiniMax: його сирі поля usage_percent / usagePercent означають залишок квоти, тому OpenClaw інвертує їх перед показом. Поля на основі кількості все одно мають пріоритет, коли вони присутні. Якщо провайдер повертає model_remains, OpenClaw надає перевагу запису чат-моделі, за потреби виводить мітку вікна з часових позначок і включає назву моделі в мітку плану.
  • Автентифікація використання для цих вікон квот надходить із provider-specific hooks, коли вони доступні; інакше OpenClaw повертається до відповідних OAuth/API-key облікових даних із профілів автентифікації, env або config.
Див. Використання токенів і витрати для деталей і прикладів.

​
Як виявляються ключі

OpenClaw може отримувати облікові дані з:
  • Профілів автентифікації (для кожного агента, зберігаються в auth-profiles.json).
  • Змінних середовища (наприклад, OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
  • Config (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
  • Skills (skills.entries.<name>.apiKey), які можуть експортувати ключі в env процесу skill.

​
Функції, які можуть витрачати ключі

​
1) Основні відповіді моделі (чат + tools)

Кожна відповідь або виклик tool використовує поточного провайдера моделі (OpenAI, Anthropic тощо). Це основне джерело використання і витрат. Сюди також входять hosted providers у стилі підписки, які все ще виставляють рахунки поза локальним UI OpenClaw, як-от OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan і шлях входу Anthropic OpenClaw Claude з увімкненим Extra Usage. Див. Моделі щодо config ціноутворення і Використання токенів і витрати щодо відображення.

​
2) Розуміння медіа (аудіо/зображення/відео)

Вхідні медіа можуть узагальнюватися/транскрибуватися до виконання відповіді. Це використовує API моделей/провайдерів.
  • Аудіо: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
  • Зображення: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
  • Відео: Google / Qwen / Moonshot.
Див. Розуміння медіа.

​
3) Генерація зображень і відео

Спільні можливості генерації також можуть витрачати ключі провайдерів:
  • Генерація зображень: OpenAI / Google / DeepInfra / fal / MiniMax
  • Генерація відео: DeepInfra / Qwen
Генерація зображень може вивести provider default з підтримкою автентифікації, коли agents.defaults.imageGenerationModel не встановлено. Генерація відео наразі вимагає явного agents.defaults.videoGenerationModel, наприклад qwen/wan2.6-t2v. Див. Генерація зображень, Qwen Cloud і Моделі.

​
4) Memory embeddings + семантичний пошук

Семантичний пошук у пам’яті використовує embedding APIs, коли налаштований для віддалених провайдерів:
  • memorySearch.provider = "openai" → OpenAI embeddings
  • memorySearch.provider = "gemini" → Gemini embeddings
  • memorySearch.provider = "voyage" → Voyage embeddings
  • memorySearch.provider = "mistral" → Mistral embeddings
  • memorySearch.provider = "deepinfra" → DeepInfra embeddings
  • memorySearch.provider = "lmstudio" → LM Studio embeddings (локальні/самостійно розміщені)
  • memorySearch.provider = "ollama" → Ollama embeddings (локальні/самостійно розміщені; зазвичай без billing hosted API)
  • Необов’язковий fallback до віддаленого провайдера, якщо локальні embeddings не спрацьовують
Ви можете залишити це локальним за допомогою memorySearch.provider = "local" (без використання API). Див. Пам’ять.

​
5) Tool вебпошуку

web_search може спричиняти плату за використання залежно від вашого провайдера:
  • Brave Search API: BRAVE_API_KEY або plugins.entries.brave.config.webSearch.apiKey
  • Exa: EXA_API_KEY або plugins.entries.exa.config.webSearch.apiKey
  • Firecrawl: FIRECRAWL_API_KEY або plugins.entries.firecrawl.config.webSearch.apiKey
  • Gemini (Google Search): GEMINI_API_KEY або plugins.entries.google.config.webSearch.apiKey
  • Grok (xAI): XAI_API_KEY або plugins.entries.xai.config.webSearch.apiKey
  • Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY або plugins.entries.moonshot.config.webSearch.apiKey
  • MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY або plugins.entries.minimax.config.webSearch.apiKey
  • Ollama Web Search: без ключа для доступного локального хоста Ollama з виконаним входом; прямий пошук https://ollama.com використовує OLLAMA_API_KEY, а захищені автентифікацією хости можуть повторно використовувати звичайну bearer auth провайдера Ollama
  • Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY або plugins.entries.perplexity.config.webSearch.apiKey
  • Tavily: TAVILY_API_KEY або plugins.entries.tavily.config.webSearch.apiKey
  • DuckDuckGo: fallback без ключа (без API billing, але неофіційний і на основі HTML)
  • SearXNG: SEARXNG_BASE_URL або plugins.entries.searxng.config.webSearch.baseUrl (без ключа/самостійно розміщений; без billing hosted API)
Застарілі шляхи провайдера tools.web.search.* усе ще завантажуються через тимчасовий compatibility shim, але вони більше не є рекомендованою поверхнею config. Безкоштовний кредит Brave Search: Кожен план Brave включає $5/місяць відновлюваного безкоштовного кредиту. План Search коштує $5 за 1 000 запитів, тож кредит покриває 1 000 запитів/місяць без плати. Встановіть ліміт використання в панелі Brave, щоб уникнути неочікуваних стягнень. Див. Веб-tools.

​
5) Tool веботримання (Firecrawl)

web_fetch може викликати Firecrawl, коли присутній API-ключ:
  • FIRECRAWL_API_KEY або plugins.entries.firecrawl.config.webFetch.apiKey
Якщо Firecrawl не налаштований, tool повертається до прямого fetch плюс bundled web-readability plugin (без платного API). Вимкніть plugins.entries.web-readability.enabled, щоб пропустити локальне вилучення Readability. Див. Веб-tools.

​
6) Знімки використання провайдерів (status/health)

Деякі команди status викликають endpoints використання провайдера, щоб показати вікна квот або стан автентифікації. Зазвичай це низькооб’ємні виклики, але вони все одно звертаються до API провайдерів:
  • openclaw status --usage
  • openclaw models status --json
Див. Models CLI.

​
7) Узагальнення запобіжника Compaction

Запобіжник compaction може узагальнювати історію сесії за допомогою поточної моделі, що викликає API провайдера під час роботи. Див. Керування сесіями + compaction.

​
8) Сканування / probe моделей

openclaw models scan може probe моделі OpenRouter і використовує OPENROUTER_API_KEY, коли probing увімкнено. Див. Models CLI.

​
9) Talk (мовлення)

Режим Talk може викликати ElevenLabs, коли налаштований:
  • ELEVENLABS_API_KEY або talk.providers.elevenlabs.apiKey
Див. Режим Talk.

​
10) Skills (сторонні API)

Skills можуть зберігати apiKey у skills.entries.<name>.apiKey. Якщо skill використовує цей ключ для зовнішніх API, це може спричинити витрати відповідно до провайдера skill. Див. Skills.

​
Пов’язане