Inference CLI
openclaw infer, sağlayıcı destekli çıkarım iş akışları için standart headless yüzeydir.
Kasıtlı olarak ham gateway RPC adlarını ve ham agent tool kimliklerini değil, yetenek ailelerini sunar.
Infer’i bir Skill’e dönüştürün
Bunu bir agent’a kopyalayıp yapıştırın:- yaygın kullanıcı niyetlerini doğru infer alt komutuna eşlemek
- kapsadığı iş akışları için birkaç standart infer örneği içermek
- örneklerde ve önerilerde
openclaw infer ...tercih etmek - tüm infer yüzeyini Skill gövdesi içinde yeniden belgelemekten kaçınmak
openclaw infer model runopenclaw infer image generateopenclaw infer audio transcribeopenclaw infer tts convertopenclaw infer web searchopenclaw infer embedding create
Neden infer kullanılmalı
openclaw infer, OpenClaw içindeki sağlayıcı destekli çıkarım görevleri için tek ve tutarlı bir CLI sağlar.
Avantajlar:
- Her backend için tek seferlik sarmalayıcılar kurmak yerine, OpenClaw’da zaten yapılandırılmış sağlayıcıları ve modelleri kullanın.
- Model, görsel, ses transkripsiyonu, TTS, video, web ve embedding iş akışlarını tek bir komut ağacı altında tutun.
- Betikler, otomasyon ve agent güdümlü iş akışları için kararlı bir
--jsonçıktı biçimi kullanın. - Görev özünde “çıkarım çalıştırmak” ise birinci taraf OpenClaw yüzeyini tercih edin.
- Çoğu infer komutu için Gateway gerektirmeden normal yerel yolu kullanın.
Komut ağacı
Yaygın görevler
Bu tablo, yaygın çıkarım görevlerini karşılık gelen infer komutuna eşler.| Görev | Komut | Notlar |
|---|---|---|
| Metin/model prompt’u çalıştır | openclaw infer model run --prompt "..." --json | Varsayılan olarak normal yerel yolu kullanır |
| Bir görsel oluştur | openclaw infer image generate --prompt "..." --json | Mevcut bir dosyadan başlıyorsanız image edit kullanın |
| Bir görsel dosyasını açıklayın | openclaw infer image describe --file ./image.png --json | --model, görsel destekli bir <provider/model> olmalıdır |
| Sesi yazıya dök | openclaw infer audio transcribe --file ./memo.m4a --json | --model, <provider/model> olmalıdır |
| Konuşma sentezleyin | openclaw infer tts convert --text "..." --output ./speech.mp3 --json | tts status, Gateway odaklıdır |
| Bir video oluştur | openclaw infer video generate --prompt "..." --json | |
| Bir video dosyasını açıklayın | openclaw infer video describe --file ./clip.mp4 --json | --model, <provider/model> olmalıdır |
| Web’de arama yap | openclaw infer web search --query "..." --json | |
| Bir web sayfası getir | openclaw infer web fetch --url https://example.com --json | |
| Embedding oluştur | openclaw infer embedding create --text "..." --json |
Davranış
openclaw infer ..., bu iş akışları için birincil CLI yüzeyidir.- Çıktı başka bir komut veya betik tarafından tüketilecekse
--jsonkullanın. - Belirli bir backend gerektiğinde
--providerveya--model provider/modelkullanın. image describe,audio transcribevevideo describeiçin--model,<provider/model>biçimini kullanmalıdır.image describeiçin açık bir--model, o sağlayıcıyı/modeli doğrudan çalıştırır. Model, model kataloğunda veya sağlayıcı yapılandırmasında görsel destekli olmalıdır.- Durumsuz yürütme komutları varsayılan olarak yereldir.
- Gateway tarafından yönetilen durum komutları varsayılan olarak Gateway’i kullanır.
- Normal yerel yol, Gateway’in çalışıyor olmasını gerektirmez.
Model
Sağlayıcı destekli metin çıkarımı ve model/sağlayıcı inceleme içinmodel kullanın.
model run, sağlayıcı/model geçersiz kılmalarının normal agent yürütmesi gibi davranması için agent çalışma zamanını yeniden kullanır.model auth login,model auth logoutvemodel auth status, kaydedilmiş sağlayıcı auth durumunu yönetir.
Görsel
Üretme, düzenleme ve açıklama içinimage kullanın.
- Mevcut girdi dosyalarıyla başlıyorsanız
image editkullanın. image describeiçin--model, görsel destekli bir<provider/model>olmalıdır.- Yerel Ollama vision modelleri için önce modeli çekin ve
OLLAMA_API_KEYdeğişkenini herhangi bir yer tutucu değerle ayarlayın; örneğinollama-local. Bkz. Ollama.
Ses
Dosya transkripsiyonu içinaudio kullanın.
audio transcribe, gerçek zamanlı oturum yönetimi için değil, dosya transkripsiyonu içindir.--model,<provider/model>olmalıdır.
TTS
Konuşma sentezi ve TTS sağlayıcı durumu içintts kullanın.
tts status, Gateway tarafından yönetilen TTS durumunu yansıttığı için varsayılan olarak Gateway’i kullanır.- TTS davranışını incelemek ve yapılandırmak için
tts providers,tts voicesvetts set-providerkullanın.
Video
Üretme ve açıklama içinvideo kullanın.
video describeiçin--model,<provider/model>olmalıdır.
Web
Arama ve getirme iş akışları içinweb kullanın.
- Kullanılabilir, yapılandırılmış ve seçili sağlayıcıları incelemek için
web providerskullanın.
Embedding
Vektör oluşturma ve embedding sağlayıcı incelemesi içinembedding kullanın.
JSON çıktısı
Infer komutları, JSON çıktısını paylaşılan bir zarf altında normalleştirir:okcapabilitytransportprovidermodelattemptsoutputserror
Yaygın tuzaklar
Notlar
openclaw capability ...,openclaw infer ...için bir takma addır.