CLI commands
Çıkarım CLI
OmeniaClaw infer, sağlayıcı destekli çıkarım iş akışları için kanonik başsız yüzeydir.
Bilinçli olarak ham Gateway RPC adlarını veya ham agent tool kimliklerini değil, yetenek ailelerini açığa çıkarır.
infer'ı bir skill'e dönüştürme
Bunu bir agent'a kopyalayıp yapıştırın:
Read https://omeniaclaw.com/cli/infer, then create a skill that routes my common workflows to `OmeniaClaw infer`.Focus on model runs, image generation, video generation, audio transcription, TTS, web search, and embeddings.İyi bir infer tabanlı skill şunları yapmalıdır:
- yaygın kullanıcı niyetlerini doğru infer alt komutuna eşleştirmelidir
- kapsadığı iş akışları için birkaç kanonik infer örneği içermelidir
- örneklerde ve önerilerde
OmeniaClaw infer ...kullanımını tercih etmelidir - skill gövdesi içinde infer yüzeyinin tamamını yeniden belgelemekten kaçınmalıdır
Tipik infer odaklı skill kapsamı:
OmeniaClaw infer model runOmeniaClaw infer image generateOmeniaClaw infer audio transcribeOmeniaClaw infer tts convertOmeniaClaw infer web searchOmeniaClaw infer embedding create
Neden infer kullanılmalı
OmeniaClaw infer, OmeniaClaw içinde sağlayıcı destekli çıkarım görevleri için tutarlı tek bir CLI sağlar.
Avantajlar:
- Her arka uç için tek seferlik sarmalayıcılar bağlamak yerine OmeniaClaw'da zaten yapılandırılmış sağlayıcıları ve modelleri kullanın.
- Model, görüntü, ses yazıya dökme, TTS, video, web ve embedding iş akışlarını tek bir komut ağacının altında tutun.
- Betikler, otomasyon ve agent odaklı iş akışları için kararlı bir
--jsonçıktı yapısı kullanın. - Görev temelde "çıkarım çalıştırmak" olduğunda birinci taraf OmeniaClaw yüzeyini tercih edin.
- Çoğu infer komutu için Gateway gerektirmeden normal yerel yolu kullanın.
Uçtan uca sağlayıcı kontrolleri için, daha düşük seviyeli sağlayıcı testleri başarılı olduktan sonra OmeniaClaw infer ... tercih edin. Bu, sağlayıcı isteği yapılmadan önce yayınlanan CLI'yi, yapılandırma yüklemeyi, varsayılan-agent çözümlemeyi, paketli Plugin etkinleştirmeyi ve paylaşılan yetenek çalışma zamanını çalıştırır.
Komut ağacı
OmeniaClaw infer list inspect model run list inspect providers auth login auth logout auth status image generate edit describe describe-many providers audio transcribe providers tts convert voices providers status enable disable set-provider video generate describe providers web search fetch providers embedding create providersYaygın görevler
Bu tablo, yaygın çıkarım görevlerini karşılık gelen infer komutuyla eşleştirir.
| Görev | Komut | Notlar |
|---|---|---|
| Bir metin/model istemi çalıştırma | OmeniaClaw infer model run --prompt "..." --json |
Varsayılan olarak normal yerel yolu kullanır |
| Görüntüler üzerinde model istemi çalıştırma | OmeniaClaw infer model run --prompt "Describe this" --file ./image.png --model provider/model |
Birden fazla görüntü girdisi için --file öğesini yineleyin |
| Görüntü oluşturma | OmeniaClaw infer image generate --prompt "..." --json |
Mevcut bir dosyadan başlarken image edit kullanın |
| Bir görüntü dosyasını açıklama | OmeniaClaw infer image describe --file ./image.png --prompt "..." --json |
--model, görüntü destekleyen bir <provider/model> olmalıdır |
| Sesi yazıya dökme | OmeniaClaw infer audio transcribe --file ./memo.m4a --json |
--model, <provider/model> olmalıdır |
| Konuşma sentezleme | OmeniaClaw infer tts convert --text "..." --output ./speech.mp3 --json |
tts status Gateway odaklıdır |
| Video oluşturma | OmeniaClaw infer video generate --prompt "..." --json |
--resolution gibi sağlayıcı ipuçlarını destekler |
| Bir video dosyasını açıklama | OmeniaClaw infer video describe --file ./clip.mp4 --json |
--model, <provider/model> olmalıdır |
| Web'de arama | OmeniaClaw infer web search --query "..." --json |
|
| Bir web sayfası getirme | OmeniaClaw infer web fetch --url https://example.com --json |
|
| Embedding oluşturma | OmeniaClaw infer embedding create --text "..." --json |
Davranış
OmeniaClaw 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 arka uç gerektiğinde
--providerveya--model provider/modelkullanın. - Çalıştırmayı ham tutarken tek seferlik bir düşünme/akıl yürütme seviyesi (
off,minimal,low,medium,high,adaptive,xhighveyamax) iletmek içinmodel run --thinking <level>kullanın. image describe,audio transcribevevideo describeiçin--model,<provider/model>biçimini kullanmalıdır.image describeiçin açık bir--model, ilgili sağlayıcı/modeli doğrudan çalıştırır. Model, model kataloğunda veya sağlayıcı yapılandırmasında görüntü destekli olmalıdır.codex/<model>, sınırlandırılmış bir Codex uygulama sunucusu görüntü anlama turu çalıştırır;openai-codex/<model>, OpenAI Codex OAuth sağlayıcı yolunu kullanır.- Durumsuz yürütme komutları varsayılan olarak yereldir.
- Gateway tarafından yönetilen durum komutları varsayılan olarak Gateway kullanır.
- Normal yerel yol, Gateway'in çalışıyor olmasını gerektirmez.
- Yerel
model run, yalın tek seferlik bir sağlayıcı tamamlama işlemidir. Yapılandırılmış agent modelini ve kimlik doğrulamayı çözümler, ancak bir sohbet-agent turu başlatmaz, araçları yüklemez veya paketli MCP sunucularını açmaz. model run --file, görüntü dosyalarını kabul eder, MIME türlerini algılar ve bunları sağlanan istemle birlikte seçili modele gönderir. Birden fazla görüntü için--fileöğesini yineleyin.model run --file, görüntü olmayan girdileri reddeder. Ses dosyaları içininfer audio transcribe, video dosyaları içininfer video describekullanın.model run --gateway, Gateway yönlendirmesini, kaydedilmiş kimlik doğrulamayı, sağlayıcı seçimini ve gömülü çalışma zamanını çalıştırır, ancak yine de ham model yoklaması olarak çalışır: sağlanan istemi ve varsa görüntü eklerini önceki oturum dökümü, bootstrap/AGENTS bağlamı, context-engine derlemesi, araçlar veya paketli MCP sunucuları olmadan gönderir.model run --gateway --model <provider/model>, istek Gateway'den tek seferlik sağlayıcı/model geçersiz kılması çalıştırmasını istediği için güvenilir operatör Gateway kimlik bilgisi gerektirir.- Yerel
model run --thinking, yalın sağlayıcı tamamlama yolunu kullanır;adaptivevemaxgibi sağlayıcıya özgü seviyeler en yakın taşınabilir basit tamamlama seviyesine eşlenir.
Model
Sağlayıcı destekli metin çıkarımı ve model/sağlayıcı incelemesi için model kullanın.
OmeniaClaw infer model run --prompt "Reply with exactly: smoke-ok" --jsonOmeniaClaw infer model run --prompt "Summarize this changelog entry" --model openai/gpt-5.4 --jsonOmeniaClaw infer model run --prompt "Describe this image in one sentence" --file ./photo.jpg --model google/gemini-2.5-flash --jsonOmeniaClaw infer model run --prompt "Use more reasoning here" --thinking high --jsonOmeniaClaw infer model providers --jsonOmeniaClaw infer model inspect --name gpt-5.5 --jsonGateway'i başlatmadan veya tam agent araç yüzeyini yüklemeden belirli bir sağlayıcıyı smoke-test etmek için tam <provider/model> referanslarını kullanın:
OmeniaClaw infer model run --local --model anthropic/claude-sonnet-4-6 --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model cerebras/zai-glm-4.7 --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model google/gemini-2.5-flash --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model groq/llama-3.1-8b-instant --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model mistral/mistral-medium-3-5 --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model mistral/mistral-small-latest --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model openai/gpt-4.1 --prompt "Reply with exactly: pong" --jsonOmeniaClaw infer model run --local --model ollama/qwen2.5vl:7b --prompt "Describe this image." --file ./photo.jpg --jsonNotlar:
- Yerel
model run, sağlayıcı/model/kimlik doğrulama sağlığı için en dar CLI smoke kontrolüdür çünkü Codex dışı sağlayıcılarda yalnızca sağlanan istemi seçili modele gönderir. - Yerel
model run --model <provider/model>, ilgili sağlayıcı yapılandırmaya yazılmadan öncemodels list --alliçindeki tam paketli statik katalog satırlarını kullanabilir. Sağlayıcı kimlik doğrulaması yine de gereklidir; eksik kimlik bilgileriUnknown modelolarak değil, kimlik doğrulama hataları olarak başarısız olur. - Mistral Medium 3.5 akıl yürütme yoklamaları için sıcaklığı ayarlanmamış/varsayılan bırakın. Mistral,
reasoning_effort="high"iletemperature: 0birleşimini reddeder; varsayılan sıcaklıkla veya0.7gibi sıfır olmayan bir akıl yürütme modu değeriylemistral/mistral-medium-3-5kullanın. openai-codex/*yerel yoklamaları dar istisnadır: OmeniaClaw, Codex Responses taşımasının gerekliinstructionsalanını doldurabilmesi için tam agent bağlamı, araçlar, bellek veya oturum dökümü eklemeden asgari bir sistem yönergesi ekler.- Yerel
model run --file, bu yalın yolu korur ve görüntü içeriğini doğrudan tek kullanıcı mesajına ekler. PNG, JPEG ve WebP gibi yaygın görüntü dosyaları, MIME türleriimage/*olarak algılandığında çalışır; desteklenmeyen veya tanınmayan dosyalar sağlayıcı çağrılmadan önce başarısız olur. model run --file, seçili çok kipli metin modelini doğrudan test etmek istediğinizde en uygunudur. OmeniaClaw'ın görüntü anlama sağlayıcı seçimini ve varsayılan görüntü-model yönlendirmesini istediğinizdeinfer image describekullanın.- Seçili model görüntü girdisini desteklemelidir; yalnızca metin modelleri isteği sağlayıcı katmanında reddedebilir.
model run --prompt, boşluk dışı metin içermelidir; boş istemler yerel sağlayıcılar veya Gateway çağrılmadan önce reddedilir.- Yerel
model run, sağlayıcı metin çıktısı döndürmediğinde sıfırdan farklı kodla çıkar; böylece ulaşılamayan yerel sağlayıcılar ve boş tamamlamalar başarılı yoklamalar gibi görünmez. - Model girdisini ham tutarken Gateway yönlendirmesini, agent çalışma zamanı kurulumunu veya Gateway tarafından yönetilen sağlayıcı durumunu test etmeniz gerektiğinde
model run --gatewaykullanın. Tam agent bağlamını, araçları, belleği ve oturum dökümünü istediğinizdeOmeniaClaw agentveya sohbet yüzeylerini kullanın. model auth login,model auth logoutvemodel auth status, kaydedilmiş sağlayıcı kimlik doğrulama durumunu yönetir.
Görüntü
Oluşturma, düzenleme ve açıklama için image kullanın.
OmeniaClaw infer image generate --prompt "friendly lobster illustration" --jsonOmeniaClaw infer image generate --prompt "cinematic product photo of headphones" --jsonOmeniaClaw infer image generate --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "simple red circle sticker on a transparent background" --jsonOmeniaClaw infer image generate --prompt "slow image backend" --timeout-ms 180000 --jsonOmeniaClaw infer image edit --file ./logo.png --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "keep the logo, remove the background" --jsonOmeniaClaw infer image edit --file ./poster.png --prompt "make this a vertical story ad" --size 2160x3840 --aspect-ratio 9:16 --resolution 4K --jsonOmeniaClaw infer image describe --file ./photo.jpg --jsonOmeniaClaw infer image describe --file ./receipt.jpg --prompt "Extract the merchant, date, and total" --jsonOmeniaClaw infer image describe-many --file ./before.png --file ./after.png --prompt "Compare the screenshots and list visible UI changes" --jsonOmeniaClaw infer image describe --file ./ui-screenshot.png --model openai/gpt-4.1-mini --jsonOmeniaClaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --prompt "Describe the image in one sentence" --timeout-ms 300000 --jsonNotlar:
-
Mevcut girdi dosyalarından başlarken
image editkullanın. -
Referans görsel düzenlemelerinde geometri ipuçlarını destekleyen sağlayıcılar/modeller için
image editile--size,--aspect-ratioveya--resolutionkullanın. -
Şeffaf arka planlı OpenAI PNG çıktısı için
--model openai/gpt-image-1.5ile--output-format png --background transparentkullanın;--openai-backgroundOpenAI'e özel bir takma ad olarak kullanılmaya devam eder. Arka plan desteği bildirmeyen sağlayıcılar, ipucunu yoksayılan bir geçersiz kılma olarak raporlar. -
Hangi paketlenmiş görüntü sağlayıcılarının keşfedilebilir, yapılandırılmış, seçilmiş olduğunu ve her sağlayıcının hangi üretim/düzenleme yeteneklerini sunduğunu doğrulamak için
image providers --jsonkullanın. -
Görüntü üretimi değişiklikleri için en dar canlı CLI smoke testi olarak
image generate --model <provider/model> --jsonkullanın. Örnek:bash OmeniaClaw infer image providers --jsonOmeniaClaw infer image generate \ --model google/gemini-3.1-flash-image-preview \ --prompt "Minimal flat test image: one blue square on a white background, no text." \ --output ./OmeniaClaw-infer-image-smoke.png \ --jsonJSON yanıtı
ok,provider,model,attemptsve yazılan çıktı yollarını raporlar.--outputayarlandığında, son uzantı sağlayıcının döndürdüğü MIME türünü izleyebilir. -
image describeveimage describe-manyiçin, görme modeline OCR, karşılaştırma, kullanıcı arayüzü incelemesi veya kısa başlık oluşturma gibi göreve özgü bir talimat vermek üzere--promptkullanın. -
Yavaş yerel görme modelleri veya soğuk Ollama başlangıçlarıyla
--timeout-mskullanın. -
image describeiçin--model, görüntü destekli bir<provider/model>olmalıdır. -
Yerel Ollama görme modelleri için önce modeli çekin ve
OLLAMA_API_KEYdeğerini herhangi bir yer tutucu değere, örneğinollama-localolarak ayarlayın. Bkz. Ollama.
Ses
Dosya transkripsiyonu için audio kullanın.
OmeniaClaw infer audio transcribe --file ./memo.m4a --jsonOmeniaClaw infer audio transcribe --file ./team-sync.m4a --language en --prompt "Focus on names and action items" --jsonOmeniaClaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --jsonNotlar:
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çin tts kullanın.
OmeniaClaw infer tts convert --text "hello from OmeniaClaw" --output ./hello.mp3 --jsonOmeniaClaw infer tts convert --text "Your build is complete" --output ./build-complete.mp3 --jsonOmeniaClaw infer tts providers --jsonOmeniaClaw infer tts status --jsonNotlar:
tts status, Gateway tarafından yönetilen TTS durumunu yansıttığı için varsayılan olarak Gateway kullanır.- TTS davranışını incelemek ve yapılandırmak için
tts providers,tts voicesvetts set-providerkullanın.
Video
Üretim ve açıklama için video kullanın.
OmeniaClaw infer video generate --prompt "cinematic sunset over the ocean" --jsonOmeniaClaw infer video generate --prompt "slow drone shot over a forest lake" --resolution 768P --duration 6 --jsonOmeniaClaw infer video describe --file ./clip.mp4 --jsonOmeniaClaw infer video describe --file ./clip.mp4 --model openai/gpt-4.1-mini --jsonNotlar:
video generate,--size,--aspect-ratio,--resolution,--duration,--audio,--watermarkve--timeout-mskabul eder ve bunları video üretimi çalışma zamanına iletir.video describeiçin--model,<provider/model>olmalıdır.
Web
Arama ve getirme iş akışları için web kullanın.
OmeniaClaw infer web search --query "OmeniaClaw docs" --jsonOmeniaClaw infer web search --query "OmeniaClaw infer web providers" --jsonOmeniaClaw infer web fetch --url https://omeniaclaw.com/cli/infer --jsonOmeniaClaw infer web providers --jsonNotlar:
- Kullanılabilir, yapılandırılmış ve seçilmiş sağlayıcıları incelemek için
web providerskullanın.
Gömme
Vektör oluşturma ve gömme sağlayıcısı incelemesi için embedding kullanın.
OmeniaClaw infer embedding create --text "friendly lobster" --jsonOmeniaClaw infer embedding create --text "customer support ticket: delayed shipment" --model openai/text-embedding-3-large --jsonOmeniaClaw infer embedding providers --jsonJSON çıktısı
Infer komutları JSON çıktısını paylaşılan bir zarf altında normalleştirir:
{ "ok": true, "capability": "image.generate", "transport": "local", "provider": "openai", "model": "gpt-image-2", "attempts": [], "outputs": []}Üst düzey alanlar kararlıdır:
okcapabilitytransportprovidermodelattemptsoutputserror
Üretilen medya komutları için outputs, OmeniaClaw tarafından yazılan dosyaları içerir. Otomasyon için insan tarafından okunabilir stdout'u ayrıştırmak yerine
bu dizideki path, mimeType, size ve medya türüne özgü boyutları kullanın.
Yaygın hatalar
# BadOmeniaClaw infer media image generate --prompt "friendly lobster" # GoodOmeniaClaw infer image generate --prompt "friendly lobster"# BadOmeniaClaw infer audio transcribe --file ./memo.m4a --model whisper-1 --json # GoodOmeniaClaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --jsonNotlar
OmeniaClaw capability ...,OmeniaClaw infer ...için bir takma addır.