Penggunaan dan biaya API

Peta fitur OpenClaw yang dapat memanggil API penyedia berbayar, lokasi setiap fitur membaca kredensialnya, dan tempat biaya yang dihasilkan ditampilkan.

Tempat biaya ditampilkan

/status (ringkasan per sesi)

• Menampilkan model sesi saat ini, penggunaan konteks, dan token respons terakhir.
• Menambahkan perkiraan biaya untuk balasan terakhir ketika OpenClaw memiliki metadata penggunaan dan harga lokal untuk model aktif, termasuk penyedia tanpa kunci API yang diberi harga secara eksplisit seperti model Bedrock aws-sdk.
• Jika ringkasan sesi langsung tidak lengkap, /status memulihkan penghitung token/cache dan label model aktif dari entri penggunaan transkrip terbaru. Nilai langsung bukan nol yang sudah ada lebih diutamakan daripada data transkrip; total transkrip sebesar ukuran prompt tetap dapat diutamakan ketika total tersimpan tidak ada atau lebih kecil.

/usage (catatan kaki per pesan)

• /usage full menambahkan catatan kaki penggunaan ke setiap balasan, termasuk perkiraan biaya ketika harga lokal dikonfigurasi dan metadata penggunaan tersedia.
• /usage tokens hanya menampilkan token. Runtime OAuth/token bergaya langganan dan CLI hanya menampilkan token, kecuali menyediakan metadata penggunaan yang kompatibel beserta harga lokal eksplisit.
• /usage cost mencetak ringkasan biaya lokal; /usage off menonaktifkan catatan kaki.
• Catatan Gemini CLI: keluaran stream-json dan json lama sama-sama membawa penggunaan di bawah stats. OpenClaw menormalisasi stats.cached menjadi cacheRead dan memperoleh token masukan dari stats.input_tokens - stats.cached bila diperlukan.

Antarmuka Kontrol → Penggunaan (analisis lintas sesi)

• Menampilkan total token dan perkiraan biaya yang diperoleh dari transkrip untuk rentang tanggal yang dipilih, dengan perincian berdasarkan penyedia, model, agen, saluran, dan jenis token.
• Membandingkan jendela kalender yang lebih singkat dan berakhir pada tanggal akhir rentang terpilih. Tanggal yang tidak ada dihitung sebagai hari kalender dengan penggunaan nol; tanggal tersebut tidak dilewati untuk membuat jendela yang lebih padat.
• Memberi label langsung pada skala grafik harian. Lencana √ berarti kompresi akar kuadrat menjaga agar hari dengan penggunaan rendah tetap terlihat.
• Total ini menjelaskan riwayat sesi lokal yang tersedia, bukan faktur penyedia atau buku besar tagihan seumur hidup. Antarmuka memperingatkan ketika harga tidak tersedia untuk beberapa entri.

Jendela penggunaan CLI (kuota penyedia, bukan biaya per pesan)

• openclaw status --usage dan openclaw channels list menampilkan jendela penggunaan penyedia sebagai X% left.
• Penyedia jendela penggunaan saat ini: Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (mencakup autentikasi OAuth/token ChatGPT/Codex), Xiaomi, dan z.ai. Lihat CLI Model dan CLI Saluran untuk daftar lengkap penyedia/flag.
• Kolom mentah usage_percent / usagePercent milik MiniMax melaporkan kuota yang tersisa, sehingga OpenClaw membalikkannya; kolom berbasis hitungan lebih diutamakan jika tersedia. Jika respons menyertakan array model_remains, OpenClaw memilih entri model percakapan, memperoleh label jendela dari stempel waktu bila diperlukan, dan menyertakan nama model dalam label paket.
• Autentikasi penggunaan berasal dari hook khusus penyedia jika tersedia; jika tidak, OpenClaw kembali mencocokkan kredensial OAuth/kunci API dari profil autentikasi, lingkungan, atau konfigurasi.

Lihat Penggunaan token dan biaya untuk contoh terperinci.

Cara kunci ditemukan

• Profil autentikasi: per agen, disimpan dalam auth-profiles.json.
• Variabel lingkungan: misalnya OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY.
• Konfigurasi: models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, agents.defaults.memorySearch.*, talk.providers.*.apiKey.
• Skills: skills.entries.<name>.apiKey, yang dapat mengekspor kunci ke lingkungan proses skill.

Fitur yang dapat menggunakan kunci berbayar

Respons model inti (percakapan + alat)

Setiap balasan atau pemanggilan alat berjalan pada penyedia model saat ini. Ini merupakan sumber utama penggunaan dan biaya, termasuk paket terkelola bergaya langganan yang ditagihkan di luar antarmuka lokal OpenClaw: OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan, dan jalur masuk Claude milik Anthropic dengan Extra Usage diaktifkan.

Lihat Model untuk konfigurasi harga dan Penggunaan token dan biaya untuk tampilan.

Pemahaman media (audio/gambar/video)

Media masuk dapat diringkas atau ditranskripsikan melalui API penyedia sebelum alur balasan berjalan. Dukungan penyedia didaftarkan per plugin dan berubah saat plugin ditambahkan; lihat Pemahaman media untuk daftar dan konfigurasi saat ini.

Pembuatan gambar dan video

image_generate dan video_generate dirutekan ke penyedia terkonfigurasi mana pun yang tersedia. Pembuatan gambar dapat menyimpulkan penyedia bawaan berbasis autentikasi ketika agents.defaults.imageGenerationModel tidak ditetapkan; pembuatan video memerlukan agents.defaults.videoGenerationModel yang ditetapkan secara eksplisit (misalnya qwen/wan2.6-t2v).

Lihat Pembuatan gambar dan Pembuatan video untuk daftar penyedia saat ini.

Embedding memori dan pencarian semantik

Pencarian memori semantik menggunakan API embedding ketika agents.defaults.memorySearch.provider menyebutkan adaptor jarak jauh (misalnya openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). memorySearch.provider = "lmstudio" atau "ollama" berjalan melalui server lokal/yang dihosting sendiri dan biasanya tidak memiliki tagihan layanan terkelola. memorySearch.provider = "local" menjaga semuanya tetap di perangkat tanpa penggunaan API. Penyedia memorySearch.fallback opsional dapat menangani kegagalan embedding lokal.

Lihat Memori.

Alat pencarian web

web_search dapat menimbulkan biaya penggunaan, tergantung pada penyedia yang dipilih. Setiap penyedia membaca kuncinya terlebih dahulu dari variabel lingkungan, lalu dari plugins.entries.<id>.config.webSearch.apiKey:

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

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

Lihat Alat web.

Alat pengambilan web (Firecrawl)

web_fetch dapat memanggil Firecrawl dengan akses awal tanpa kunci; tambahkan FIRECRAWL_API_KEY (atau plugins.entries.firecrawl.config.webFetch.apiKey) untuk batas yang lebih tinggi. Jika Firecrawl tidak dikonfigurasi, alat akan kembali ke pengambilan langsung beserta plugin web-readability bawaan (tanpa API berbayar). Nonaktifkan plugins.entries.web-readability.enabled untuk melewati ekstraksi Readability lokal.

Lihat Alat web.

Ringkasan penggunaan penyedia (status/kesehatan)

openclaw status --usage dan openclaw models status --json memanggil titik akhir penggunaan penyedia untuk menampilkan jendela kuota atau kesehatan autentikasi. Volume panggilan rendah, tetapi tetap mengakses API penyedia.

Lihat CLI Model.

Peringkasan pengaman Compaction

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

Lihat Pengelolaan sesi dan Compaction.

Pemindaian / pemeriksaan model

openclaw models scan dapat memeriksa model OpenRouter dan menggunakan OPENROUTER_API_KEY ketika pemeriksaan diaktifkan.

Lihat CLI Model.

Percakapan (ucapan)

Mode percakapan dapat memanggil ElevenLabs ketika dikonfigurasi: ELEVENLABS_API_KEY atau talk.providers.elevenlabs.apiKey.

Lihat Mode percakapan.

Skills (API pihak ketiga)

Skills dapat menyimpan apiKey dalam skills.entries.<name>.apiKey. Jika sebuah skill menggunakan kunci tersebut untuk mengakses API eksternal, biayanya mengikuti penyedia skill tersebut.

Lihat Skills.

Terkait

• Penggunaan token dan biaya
• Penyimpanan cache prompt
• Pelacakan penggunaan