Skip to main content
openclaw infer adalah antarmuka headless kanonis untuk inferensi yang didukung penyedia. Antarmuka ini mengekspos kelompok kapabilitas (model, image, audio, tts, video, web, embedding), bukan nama RPC Gateway mentah atau id alat agen. openclaw capability ... adalah alias untuk pohon perintah yang sama. Alasan untuk memilihnya daripada pembungkus penyedia sekali pakai:
  • Menggunakan kembali penyedia dan model yang sudah dikonfigurasi di OpenClaw.
  • Amplop --json yang stabil untuk skrip dan otomatisasi berbasis agen (lihat keluaran JSON).
  • Menjalankan jalur lokal normal tanpa Gateway untuk sebagian besar subperintah.
  • Untuk pemeriksaan penyedia menyeluruh, perintah ini menguji CLI yang didistribusikan, pemuatan konfigurasi, resolusi agen default, aktivasi Plugin bawaan, dan runtime kapabilitas bersama sebelum permintaan dikirim ke penyedia.

​
Ubah infer menjadi skill

Salin dan tempelkan ini ke agen:
Skill berbasis infer yang baik memetakan maksud umum pengguna ke subperintah yang tepat, menyertakan beberapa contoh kanonis untuk setiap alur kerja, memilih openclaw infer ... daripada alternatif tingkat rendah, dan tidak mendokumentasikan ulang seluruh antarmuka infer di isi skill.

​
Pohon perintah

infer list / infer inspect --name <capability> menampilkan pohon ini sebagai data (id kapabilitas, transportasi, deskripsi).

​
Tugas umum

​
Perilaku

  • Gunakan --json ketika keluaran diteruskan ke perintah atau skrip lain; gunakan keluaran teks untuk kasus lainnya.
  • Gunakan --provider atau --model provider/model untuk menetapkan backend tertentu.
  • Gunakan model run --thinking <level> untuk menimpa pemikiran/penalaran satu kali: off, minimal, low, medium, high, adaptive, xhigh, atau max.
  • Untuk image describe, audio transcribe, dan video describe, --model harus menggunakan format <provider/model>.
  • Untuk image describe, --file menerima jalur lokal dan URL HTTP(S); URL jarak jauh diproses melalui kebijakan SSRF pengambilan media normal.
  • Perintah eksekusi tanpa status (model run, image *, audio *, video *, web *, embedding *) menggunakan lokal secara default. Perintah status yang dikelola Gateway (tts status) menggunakan Gateway secara default.
  • Jalur lokal tidak pernah mengharuskan Gateway berjalan.
  • model run lokal adalah penyelesaian penyedia sekali jalan yang ramping: perintah ini menyelesaikan model dan autentikasi agen yang dikonfigurasi, tetapi tidak memulai giliran agen percakapan, memuat alat, atau membuka server MCP bawaan.
  • model run --file melampirkan berkas gambar (jenis MIME dideteksi otomatis) ke perintah; ulangi --file untuk beberapa gambar. Berkas bukan gambar ditolak — gunakan infer audio transcribe atau infer video describe sebagai gantinya.
  • model run --gateway menguji perutean Gateway, autentikasi tersimpan, pemilihan penyedia, dan runtime tertanam, tetapi tetap menjadi pemeriksaan model mentah: tanpa transkrip sesi sebelumnya, konteks bootstrap/AGENTS, alat, atau server MCP bawaan.
  • model run --gateway --model <provider/model> memerlukan kredensial Gateway operator tepercaya karena perintah ini meminta Gateway menjalankan penggantian penyedia/model sekali pakai.

​
Model

Inferensi teks serta pemeriksaan model/penyedia.
Gunakan referensi <provider/model> lengkap dengan --local untuk menguji cepat satu penyedia tanpa memulai Gateway atau memuat antarmuka alat agen:
Catatan:
  • model run lokal adalah pengujian cepat CLI tersempit untuk kesehatan penyedia/model/autentikasi: untuk penyedia selain ChatGPT-Codex, perintah ini hanya mengirim perintah yang diberikan.
  • model run --model <provider/model> lokal dapat menyelesaikan baris katalog statis bawaan yang tepat (baris yang sama dengan yang ditampilkan openclaw models list --all) sebelum penyedia tersebut ditulis ke konfigurasi. Autentikasi penyedia tetap diperlukan; kredensial yang tidak tersedia menghasilkan galat autentikasi, bukan Unknown model.
  • Untuk pemeriksaan penalaran Mistral Medium 3.5, biarkan suhu tidak ditetapkan/default. Mistral menolak reasoning_effort="high" dengan temperature: 0; gunakan suhu default atau nilai bukan nol seperti 0.7.
  • Pemeriksaan lokal OAuth OpenAI ChatGPT/Codex (API openai-chatgpt-responses) menambahkan instruksi sistem minimal agar transportasi dapat mengisi bidang instructions yang diwajibkan — tanpa konteks agen lengkap, alat, memori, atau transkrip sesi.
  • model run --file melampirkan konten gambar langsung ke satu pesan pengguna. Format umum (PNG, JPEG, WebP) berfungsi ketika jenis MIME terdeteksi sebagai image/*; berkas yang tidak didukung atau tidak dikenali gagal sebelum penyedia dipanggil. Gunakan infer image describe sebagai gantinya ketika Anda menginginkan perutean dan mekanisme cadangan model gambar OpenClaw, bukan pemeriksaan model multimodal langsung.
  • Model yang dipilih harus mendukung masukan gambar; model khusus teks dapat menolak permintaan pada lapisan penyedia.
  • model run --prompt harus berisi teks selain spasi kosong; perintah kosong ditolak sebelum panggilan penyedia atau Gateway.
  • model run lokal keluar dengan kode bukan nol ketika penyedia tidak mengembalikan keluaran teks, sehingga penyedia yang tidak dapat dijangkau dan penyelesaian kosong tidak tampak sebagai pemeriksaan yang berhasil.
  • Gunakan model run --gateway untuk menguji perutean Gateway atau penyiapan runtime agen sambil mempertahankan masukan model dalam bentuk mentah. Gunakan openclaw agent atau antarmuka percakapan untuk konteks agen lengkap, alat, memori, dan transkrip sesi.
  • --thinking adaptive dipetakan ke medium tingkat runtime penyelesaian; --thinking max dipetakan ke max untuk model OpenAI yang mendukung upaya maksimum bawaan, atau xhigh jika tidak.
  • model auth login, model auth logout, dan model auth status mengelola status autentikasi penyedia yang tersimpan.

​
Gambar

Pembuatan, pengeditan, dan deskripsi.
Catatan:
  • Gunakan image edit saat memulai dari berkas masukan yang sudah ada; --size, --aspect-ratio, atau --resolution menambahkan petunjuk geometri pada penyedia/model yang mendukungnya.
  • --output-format png --background transparent dengan --model openai/gpt-image-1.5 menghasilkan keluaran PNG OpenAI dengan latar belakang transparan; --openai-background adalah alias khusus OpenAI untuk petunjuk yang sama. Penyedia yang tidak menyatakan dukungan latar belakang melaporkannya sebagai penggantian yang diabaikan (lihat ignoredOverrides dalam amplop JSON).
  • --quality low|medium|high|auto berfungsi untuk penyedia yang mendukung petunjuk kualitas gambar, termasuk OpenAI. OpenAI juga menerima --openai-moderation low|auto.
  • image providers --json mencantumkan penyedia gambar bawaan yang dapat ditemukan, dikonfigurasi, dan dipilih, serta kemampuan pembuatan/penyuntingan yang disediakan oleh masing-masing penyedia.
  • image generate --model <provider/model> --json adalah pengujian langsung paling terbatas untuk perubahan pembuatan gambar:
    Respons melaporkan ok, provider, model, attempts, dan jalur keluaran yang ditulis. Saat --output ditetapkan, ekstensi akhir dapat mengikuti jenis MIME yang dikembalikan penyedia.
  • Untuk image describe dan image describe-many, gunakan --prompt untuk instruksi khusus tugas (OCR, perbandingan, pemeriksaan UI, pemberian keterangan singkat).
  • Gunakan --timeout-ms untuk model visi lokal yang lambat atau proses awal Ollama dari kondisi dingin.
  • Untuk image describe, --model eksplisit (harus berupa <provider/model> yang mendukung gambar) dijalankan terlebih dahulu, lalu mencoba agents.defaults.imageModel.fallbacks yang dikonfigurasi jika panggilan tersebut gagal. Kesalahan penyiapan masukan (berkas tidak ada, URL tidak didukung) menyebabkan kegagalan sebelum upaya pengalihan apa pun, dan model harus mendukung gambar dalam katalog model atau konfigurasi penyedia.
  • Untuk model visi Ollama lokal, tarik model terlebih dahulu dan tetapkan OLLAMA_API_KEY ke nilai tempat penampung apa pun, misalnya ollama-local. Lihat Ollama.

​
Audio

Transkripsi berkas (bukan pengelolaan sesi waktu nyata).
--model harus berupa <provider/model>.

​
TTS

Sintesis ucapan serta status penyedia/persona TTS.
Catatan:
  • tts status hanya mendukung --gateway (ini mencerminkan status TTS yang dikelola Gateway).
  • Gunakan tts providers, tts voices, tts personas, tts set-provider, dan tts set-persona untuk memeriksa dan mengonfigurasi perilaku TTS.

​
Video

Pembuatan dan deskripsi.
Catatan:
  • video generate menerima --size, --aspect-ratio, --resolution, --duration, --audio, --watermark, dan --timeout-ms, yang diteruskan ke runtime pembuatan video.
  • --model harus berupa <provider/model> untuk video describe.

​
Web

Pencarian dan pengambilan.
web providers mencantumkan penyedia yang tersedia, dikonfigurasi, dan dipilih untuk pencarian dan pengambilan.

​
Penyematan

Pembuatan vektor dan pemeriksaan penyedia penyematan.

​
Keluaran JSON

Perintah infer menormalkan keluaran JSON di bawah amplop bersama:
Kolom tingkat teratas yang stabil:
  • ok
  • capability
  • transport
  • provider
  • model
  • attempts
  • inputs (lampiran gambar yang dikirim bersama permintaan, jika berlaku)
  • outputs
  • ignoredOverrides (kunci petunjuk yang tidak didukung penyedia, jika berlaku)
  • error
Untuk perintah media yang dihasilkan, outputs berisi berkas yang ditulis oleh OpenClaw. Gunakan path, mimeType, size, dan dimensi khusus media apa pun dalam larik tersebut untuk otomatisasi, alih-alih mengurai stdout yang dapat dibaca manusia.

​
Kesalahan umum

​
Terkait