English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Technical reference

Penggunaan dan biaya API

Dokumen ini mencantumkan fitur yang dapat menggunakan kunci API dan tempat biayanya muncul. Dokumen ini berfokus pada fitur OpenClaw yang dapat menghasilkan penggunaan penyedia atau panggilan API berbayar.

Tempat biaya muncul (chat + CLI)

Snapshot biaya per sesi

  • /status menampilkan model sesi saat ini, penggunaan konteks, dan token respons terakhir.
  • Jika model menggunakan auth kunci API, /status juga menampilkan perkiraan biaya untuk balasan terakhir.
  • Jika metadata sesi langsung terbatas, /status dapat memulihkan penghitung token/cache dan label model runtime aktif dari entri penggunaan transkrip terbaru. Nilai langsung nonnol yang sudah ada tetap diprioritaskan, dan total transkrip sebesar prompt dapat menang ketika total tersimpan hilang atau lebih kecil.

Footer biaya per pesan

  • /usage full menambahkan footer penggunaan ke setiap balasan, termasuk perkiraan biaya (hanya kunci API).
  • /usage tokens hanya menampilkan token; alur OAuth/token bergaya langganan dan CLI menyembunyikan biaya dolar.
  • Catatan Gemini CLI: ketika CLI mengembalikan output JSON, OpenClaw membaca penggunaan dari stats, menormalisasi stats.cached menjadi cacheRead, dan menurunkan token input dari stats.input_tokens - stats.cached bila diperlukan.

Catatan Anthropic: staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI bergaya OpenClaw diizinkan lagi, sehingga OpenClaw memperlakukan penggunaan ulang Claude CLI dan penggunaan claude -p sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru. Anthropic masih tidak mengekspos perkiraan dolar per pesan yang dapat ditampilkan OpenClaw di /usage full.

Jendela penggunaan CLI (kuota penyedia)

  • openclaw status --usage dan openclaw channels list menampilkan jendela penggunaan penyedia (snapshot kuota, bukan biaya per pesan).
  • Output manusia dinormalisasi menjadi X% left di semua penyedia.
  • Penyedia jendela penggunaan saat ini: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi, dan z.ai.
  • Catatan MiniMax: kolom mentah usage_percent / usagePercent berarti kuota tersisa, sehingga OpenClaw membalikkannya sebelum ditampilkan. Kolom berbasis hitungan tetap menang ketika ada. Jika penyedia mengembalikan model_remains, OpenClaw memprioritaskan entri model chat, menurunkan label jendela dari timestamp bila diperlukan, dan menyertakan nama model dalam label paket.
  • Auth penggunaan untuk jendela kuota tersebut berasal dari hook khusus penyedia ketika tersedia; jika tidak, OpenClaw fallback ke kredensial OAuth/kunci API yang cocok dari profil auth, env, atau config.

Lihat Penggunaan token & biaya untuk detail dan contoh.

Cara kunci ditemukan

OpenClaw dapat mengambil kredensial dari:

  • Profil auth (per agen, disimpan di auth-profiles.json).
  • Variabel lingkungan (mis. 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) yang dapat mengekspor kunci ke env proses skill.

Fitur yang dapat menggunakan kunci

1) Respons model inti (chat + alat)

Setiap balasan atau panggilan alat menggunakan penyedia model saat ini (OpenAI, Anthropic, dll.). Ini adalah sumber utama penggunaan dan biaya.

Ini juga mencakup penyedia hosted bergaya langganan yang tetap menagih di luar UI lokal OpenClaw, seperti OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan, dan jalur login Claude OpenClaw milik Anthropic dengan Extra Usage diaktifkan.

Lihat Model untuk config harga dan Penggunaan token & biaya untuk tampilan.

2) Pemahaman media (audio/gambar/video)

Media masuk dapat diringkas/ditranskripsi sebelum balasan dijalankan. Ini menggunakan API model/penyedia.

  • Audio: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
  • Gambar: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
  • Video: Google / Qwen / Moonshot.

Lihat Pemahaman media.

3) Pembuatan gambar dan video

Kapabilitas pembuatan bersama juga dapat menggunakan kunci penyedia:

  • Pembuatan gambar: OpenAI / Google / DeepInfra / fal / MiniMax
  • Pembuatan video: DeepInfra / Qwen

Pembuatan gambar dapat menyimpulkan default penyedia berbasis auth ketika agents.defaults.imageGenerationModel belum disetel. Pembuatan video saat ini memerlukan agents.defaults.videoGenerationModel eksplisit seperti qwen/wan2.6-t2v.

Lihat Pembuatan gambar, Qwen Cloud, dan Model.

4) Embedding memori + pencarian semantik

Pencarian memori semantik menggunakan API embedding ketika dikonfigurasi untuk penyedia remote:

  • memorySearch.provider = "openai" → embedding OpenAI
  • memorySearch.provider = "gemini" → embedding Gemini
  • memorySearch.provider = "voyage" → embedding Voyage
  • memorySearch.provider = "mistral" → embedding Mistral
  • memorySearch.provider = "deepinfra" → embedding DeepInfra
  • memorySearch.provider = "lmstudio" → embedding LM Studio (lokal/self-hosted)
  • memorySearch.provider = "ollama" → embedding Ollama (lokal/self-hosted; biasanya tanpa penagihan API hosted)
  • Fallback opsional ke penyedia remote jika embedding lokal gagal

Anda dapat menjaganya tetap lokal dengan memorySearch.provider = "local" (tanpa penggunaan API).

Lihat Memori.

5) Alat pencarian web

web_search dapat menimbulkan biaya penggunaan tergantung penyedia Anda:

  • Brave Search API: BRAVE_API_KEY atau plugins.entries.brave.config.webSearch.apiKey
  • Exa: EXA_API_KEY atau plugins.entries.exa.config.webSearch.apiKey
  • Firecrawl: FIRECRAWL_API_KEY atau plugins.entries.firecrawl.config.webSearch.apiKey
  • Gemini (Google Search): GEMINI_API_KEY atau plugins.entries.google.config.webSearch.apiKey
  • Grok (xAI): XAI_API_KEY atau plugins.entries.xai.config.webSearch.apiKey
  • Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY, atau plugins.entries.moonshot.config.webSearch.apiKey
  • MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY, atau plugins.entries.minimax.config.webSearch.apiKey
  • Ollama Web Search: tanpa kunci untuk host Ollama lokal yang dapat dijangkau dan sudah login; pencarian langsung https://ollama.com menggunakan OLLAMA_API_KEY, dan host yang dilindungi auth dapat menggunakan ulang auth bearer penyedia Ollama normal
  • Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY, atau plugins.entries.perplexity.config.webSearch.apiKey
  • Tavily: TAVILY_API_KEY atau plugins.entries.tavily.config.webSearch.apiKey
  • DuckDuckGo: fallback tanpa kunci (tanpa penagihan API, tetapi tidak resmi dan berbasis HTML)
  • SearXNG: SEARXNG_BASE_URL atau plugins.entries.searxng.config.webSearch.baseUrl (tanpa kunci/self-hosted; tanpa penagihan API hosted)

Jalur penyedia lama tools.web.search.* masih dimuat melalui shim kompatibilitas sementara, tetapi tidak lagi menjadi permukaan config yang direkomendasikan.

Kredit gratis Brave Search: Setiap paket Brave menyertakan kredit gratis $5/bulan yang diperbarui. Paket Search berbiaya $5 per 1.000 permintaan, sehingga kredit tersebut mencakup 1.000 permintaan/bulan tanpa biaya. Tetapkan batas penggunaan Anda di dashboard Brave untuk menghindari biaya tak terduga.

Lihat Alat web.

5) Alat fetch web (Firecrawl)

web_fetch dapat memanggil Firecrawl ketika ada kunci API:

  • FIRECRAWL_API_KEY atau plugins.entries.firecrawl.config.webFetch.apiKey

Jika Firecrawl tidak dikonfigurasi, alat fallback ke fetch langsung ditambah Plugin web-readability bawaan (tanpa API berbayar). Nonaktifkan plugins.entries.web-readability.enabled untuk melewati ekstraksi Readability lokal.

Lihat Alat web.

6) Snapshot penggunaan penyedia (status/kesehatan)

Beberapa perintah status memanggil endpoint penggunaan penyedia untuk menampilkan jendela kuota atau kesehatan auth. Ini biasanya panggilan bervolume rendah tetapi tetap mengenai API penyedia:

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

Lihat CLI model.

7) Perangkuman pelindung Compaction

Pelindung Compaction dapat meringkas riwayat sesi menggunakan model saat ini, yang memanggil API penyedia ketika berjalan.

Lihat Manajemen sesi + compaction.

8) Pemindaian / probe model

openclaw models scan dapat mem-probe model OpenRouter dan menggunakan OPENROUTER_API_KEY ketika probe diaktifkan.

Lihat CLI model.

9) Talk (ucapan)

Mode Talk dapat memanggil ElevenLabs ketika dikonfigurasi:

  • ELEVENLABS_API_KEY atau talk.providers.elevenlabs.apiKey

Lihat Mode Talk.

10) Skills (API pihak ketiga)

Skills dapat menyimpan apiKey di skills.entries.<name>.apiKey. Jika sebuah skill menggunakan kunci tersebut untuk API eksternal, hal itu dapat menimbulkan biaya sesuai penyedia skill.

Lihat Skills.

Terkait