Inferentie-CLI

openclaw infer is de canonieke headless-interface voor door providers ondersteunde inferentie. Deze biedt capaciteitsfamilies (model, image, audio, tts, video, web, embedding), geen onbewerkte RPC-namen van de Gateway of id's van agenttools. openclaw capability ... is een alias voor dezelfde opdrachtstructuur.

Redenen om dit te verkiezen boven een eenmalige providerwrapper:

• Hergebruikt providers en modellen die al in OpenClaw zijn geconfigureerd.
• Stabiele --json-envelop voor scripts en door agents aangestuurde automatisering (zie JSON-uitvoer).
• Voert voor de meeste subopdrachten het normale lokale pad uit zonder de Gateway.
• Voor end-to-end-providercontroles doorloopt dit de meegeleverde CLI, het laden van configuratie, de resolutie van de standaardagent, de activering van gebundelde plugins en de gedeelde capaciteitsruntime voordat het providerverzoek wordt verzonden.

Maak van infer een skill

Kopieer en plak dit naar een agent:

Lees https://docs.openclaw.ai/cli/infer en maak vervolgens een skill die mijn gebruikelijke werkstromen naar `openclaw infer` routeert.Richt je op modeluitvoeringen, het genereren van afbeeldingen, het genereren van video's, audiotranscriptie, TTS, zoeken op het web en embeddings.

Een goede op infer gebaseerde skill koppelt veelvoorkomende gebruikersintenties aan de juiste subopdracht, bevat per werkstroom enkele canonieke voorbeelden, geeft de voorkeur aan openclaw infer ... boven alternatieven op lager niveau en documenteert niet de volledige infer-interface opnieuw in de hoofdtekst van de skill.

Opdrachtstructuur

 openclaw 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    personas    status    enable    disable    set-provider    set-persona   video    generate    describe    providers   web    search    fetch    providers   embedding    create    providers

infer list / infer inspect --name <capability> tonen deze structuur als gegevens (capaciteits-id, transporten, beschrijving).

Veelvoorkomende taken

Gedrag

• Gebruik --json wanneer de uitvoer als invoer voor een andere opdracht of een script dient; gebruik anders tekstuitvoer.
• Gebruik --provider of --model provider/model om een specifieke backend vast te zetten.
• Gebruik model run --thinking <level> om het denk-/redeneerniveau voor één uitvoering te overschrijven: off, minimal, low, medium, high, adaptive, xhigh of max.
• Voor image describe, audio transcribe en video describe moet --model de vorm <provider/model> hebben.
• Voor image describe accepteert --file lokale paden en HTTP(S)-URL's; externe URL's worden verwerkt volgens het normale SSRF-beleid voor het ophalen van media.
• Statusloze uitvoeringsopdrachten (model run, image *, audio *, video *, web *, embedding *) zijn standaard lokaal. Door de Gateway beheerde statusopdrachten (tts status) gebruiken standaard de Gateway.
• Voor het lokale pad hoeft de Gateway nooit actief te zijn.
• Lokale model run is een gestroomlijnde, eenmalige provider-voltooiing: deze resolveert het geconfigureerde agentmodel en de authenticatie, maar start geen chatagentbeurt, laadt geen tools en opent geen gebundelde MCP-servers.
• model run --file voegt afbeeldingsbestanden (met automatisch gedetecteerd MIME-type) aan de prompt toe; herhaal --file voor meerdere afbeeldingen. Niet-afbeeldingsbestanden worden geweigerd — gebruik in plaats daarvan infer audio transcribe of infer video describe.
• model run --gateway test de routering van de Gateway, opgeslagen authenticatie, providerselectie en de ingebedde runtime, maar blijft een onbewerkte modelprobe: geen eerder sessietranscript, bootstrap-/AGENTS-context, tools of gebundelde MCP-servers.
• model run --gateway --model <provider/model> vereist Gateway-referenties van een vertrouwde operator, omdat hiermee aan de Gateway wordt gevraagd een eenmalige provider-/modeloverschrijving uit te voeren.

Model

Tekstinferentie en inspectie van modellen/providers.

openclaw infer model run --prompt "Reply with exactly: smoke-ok" --jsonopenclaw infer model run --prompt "Summarize this changelog entry" --model openai/gpt-5.4 --jsonopenclaw infer model run --prompt "Describe this image in one sentence" --file ./photo.jpg --model google/gemini-2.5-flash --jsonopenclaw infer model run --prompt "Use more reasoning here" --thinking high --jsonopenclaw infer model providers --jsonopenclaw infer model inspect --model gpt-5.6-sol --json

Gebruik volledige <provider/model>-verwijzingen met --local om één provider kort te testen zonder de Gateway te starten of de agenttool-interface te laden:

openclaw infer model run --local --model anthropic/claude-sonnet-4-6 --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model cerebras/zai-glm-4.7 --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model google/gemini-2.5-flash --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model groq/llama-3.1-8b-instant --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model mistral/mistral-medium-3-5 --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model mistral/mistral-small-latest --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model openai/gpt-5.6-luna --prompt "Reply with exactly: pong" --jsonopenclaw infer model run --local --model ollama/qwen2.5vl:7b --prompt "Describe this image." --file ./photo.jpg --json

Opmerkingen:

• Lokale model run is de meest gerichte CLI-rooktest voor de werking van provider/model/authenticatie: voor providers anders dan ChatGPT-Codex wordt alleen de opgegeven prompt verzonden.
• Lokale model run --model <provider/model> kan exacte rijen uit de gebundelde statische catalogus resolven (dezelfde rijen die openclaw models list --all toont) voordat die provider naar de configuratie is geschreven. Providerauthenticatie blijft vereist; ontbrekende referenties leveren authenticatiefouten op, niet Unknown model.
• Laat voor redeneerprobes met Mistral Medium 3.5 de temperatuur oningesteld/op de standaardwaarde. Mistral weigert reasoning_effort="high" met temperature: 0; gebruik de standaardtemperatuur of een waarde die niet nul is, zoals 0.7.
• Lokale probes met OpenAI ChatGPT/Codex OAuth (openai-chatgpt-responses-API) voegen een minimale systeeminstructie toe, zodat het transport het vereiste veld instructions kan invullen — zonder volledige agentcontext, tools, geheugen of sessietranscript.
• model run --file voegt afbeeldingsinhoud rechtstreeks toe aan het enige gebruikersbericht. Gangbare indelingen (PNG, JPEG, WebP) werken wanneer het MIME-type als image/* wordt gedetecteerd; niet-ondersteunde of niet-herkende bestanden mislukken voordat de provider wordt aangeroepen. Gebruik in plaats daarvan infer image describe wanneer je de routering en fallbacks van OpenClaw voor afbeeldingsmodellen wilt gebruiken in plaats van een directe multimodale modelprobe.
• Het geselecteerde model moet afbeeldingsinvoer ondersteunen; modellen die alleen tekst ondersteunen, kunnen het verzoek op providerniveau weigeren.
• model run --prompt moet tekst bevatten die niet uitsluitend uit witruimte bestaat; lege prompts worden geweigerd voordat een provider of de Gateway wordt aangeroepen.
• Lokale model run eindigt met een niet-nulcode wanneer de provider geen tekstuitvoer retourneert, zodat onbereikbare providers en lege voltooiingen niet als geslaagde probes worden weergegeven.
• Gebruik model run --gateway om de routering van de Gateway of de configuratie van de agentruntime te testen terwijl de modelinvoer onbewerkt blijft. Gebruik openclaw agent of een chatinterface voor volledige agentcontext, tools, geheugen en sessietranscript.
• --thinking adaptive wordt gekoppeld aan het voltooiingsruntimeniveau medium; --thinking max wordt gekoppeld aan max voor OpenAI-modellen die de eigen maximale inspanning ondersteunen, en anders aan xhigh.
• model auth login, model auth logout en model auth status beheren de opgeslagen providerauthenticatiestatus.

Afbeelding

Genereren, bewerken en beschrijven.

openclaw infer image generate --prompt "friendly lobster illustration" --jsonopenclaw infer image generate --prompt "cinematic product photo of headphones" --jsonopenclaw infer image generate --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "simple red circle sticker on a transparent background" --jsonopenclaw infer image generate --model openai/gpt-image-2 --quality low --openai-moderation low --prompt "low-cost draft poster" --jsonopenclaw infer image generate --prompt "slow image backend" --timeout-ms 180000 --jsonopenclaw infer image edit --file ./logo.png --model openai/gpt-image-1.5 --output-format png --background transparent --prompt "keep the logo, remove the background" --jsonopenclaw infer image edit --file ./poster.png --prompt "make this a vertical story ad" --size 2160x3840 --aspect-ratio 9:16 --resolution 4K --jsonopenclaw infer image describe --file ./photo.jpg --jsonopenclaw infer image describe --file https://example.com/photo.png --jsonopenclaw infer image describe --file ./receipt.jpg --prompt "Extract the merchant, date, and total" --jsonopenclaw infer image describe-many --file ./before.png --file ./after.png --prompt "Compare the screenshots and list visible UI changes" --jsonopenclaw infer image describe --file ./ui-screenshot.png --model openai/gpt-5.4-mini --jsonopenclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --prompt "Describe the image in one sentence" --timeout-ms 300000 --json

Opmerkingen:

• Gebruik image edit wanneer u begint met bestaande invoerbestanden; --size, --aspect-ratio en --resolution voegen geometrieaanwijzingen toe voor providers/modellen die deze ondersteunen.

• --output-format png --background transparent met --model openai/gpt-image-1.5 levert OpenAI-PNG-uitvoer met een transparante achtergrond; --openai-background is een OpenAI-specifieke alias voor dezelfde aanwijzing. Providers die geen ondersteuning voor achtergronden declareren, melden deze als een genegeerde overschrijving (zie ignoredOverrides in de JSON-envelop).

• --quality low|medium|high|auto werkt voor providers die aanwijzingen voor beeldkwaliteit ondersteunen, waaronder OpenAI. OpenAI accepteert ook --openai-moderation low|auto.

• image providers --json vermeldt welke gebundelde afbeeldingsproviders detecteerbaar, geconfigureerd en geselecteerd zijn, en welke generatie- en bewerkingsmogelijkheden elke provider biedt.

• image generate --model <provider/model> --json is de meest gerichte live-rooktest voor wijzigingen in afbeeldingsgeneratie:

  openclaw infer image providers --jsonopenclaw 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 ./openclaw-infer-image-smoke.png \  --json

  Het antwoord vermeldt ok, provider, model, attempts en de paden van de geschreven uitvoerbestanden. Wanneer --output is ingesteld, kan de uiteindelijke extensie het door de provider geretourneerde MIME-type volgen.

• Gebruik voor image describe en image describe-many de optie --prompt voor een taakspecifieke instructie (OCR, vergelijking, inspectie van de gebruikersinterface, beknopte bijschriften).

• Gebruik --timeout-ms voor trage lokale visiemodellen of een koude start van Ollama.

• Voor image describe wordt eerst een expliciet --model uitgevoerd (dit moet een afbeeldingsgeschikt <provider/model> zijn), waarna geconfigureerde agents.defaults.imageModel.fallbacks worden geprobeerd als die aanroep mislukt. Fouten bij het voorbereiden van invoer (ontbrekend bestand, niet-ondersteunde URL) veroorzaken een fout voordat een terugvalpoging wordt gedaan, en het model moet in de modelcatalogus of providerconfiguratie als afbeeldingsgeschikt zijn aangemerkt.

• Voor lokale Ollama-visiemodellen haalt u eerst het model op en stelt u OLLAMA_API_KEY in op een willekeurige tijdelijke waarde, bijvoorbeeld ollama-local. Zie Ollama.

Audio

Bestandstranscriptie (geen realtime sessiebeheer).

openclaw infer audio transcribe --file ./memo.m4a --jsonopenclaw infer audio transcribe --file ./team-sync.m4a --language en --prompt "Focus on names and action items" --jsonopenclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --json

--model moet <provider/model> zijn.

TTS

Spraaksynthese en de status van TTS-providers/persona's.

openclaw infer tts convert --text "hello from openclaw" --output ./hello.mp3 --jsonopenclaw infer tts convert --text "Your build is complete" --output ./build-complete.mp3 --jsonopenclaw infer tts providers --jsonopenclaw infer tts personas --jsonopenclaw infer tts status --json

Opmerkingen:

• tts status ondersteunt alleen --gateway (dit weerspiegelt de door de Gateway beheerde TTS-status).
• Gebruik tts providers, tts voices, tts personas, tts set-provider en tts set-persona om het TTS-gedrag te inspecteren en configureren.

Video

Generatie en beschrijving.

openclaw infer video generate --prompt "cinematic sunset over the ocean" --jsonopenclaw infer video generate --prompt "slow drone shot over a forest lake" --resolution 768P --duration 6 --jsonopenclaw infer video describe --file ./clip.mp4 --jsonopenclaw infer video describe --file ./clip.mp4 --model openai/gpt-5.4-mini --json

Opmerkingen:

• video generate accepteert --size, --aspect-ratio, --resolution, --duration, --audio, --watermark en --timeout-ms, die worden doorgegeven aan de runtime voor videogeneratie.
• Voor video describe moet --model de vorm <provider/model> hebben.

Web

Zoeken en ophalen.

openclaw infer web search --query "OpenClaw docs" --jsonopenclaw infer web search --query "OpenClaw infer web providers" --jsonopenclaw infer web fetch --url https://docs.openclaw.ai/cli/infer --jsonopenclaw infer web providers --json

web providers vermeldt de beschikbare, geconfigureerde en geselecteerde providers voor zoeken en ophalen.

Insluiting

Vectoren maken en insluitingsproviders inspecteren.

openclaw infer embedding create --text "friendly lobster" --jsonopenclaw infer embedding create --text "customer support ticket: delayed shipment" --model openai/text-embedding-3-large --jsonopenclaw infer embedding providers --json

JSON-uitvoer

Infer-opdrachten normaliseren JSON-uitvoer onder een gedeelde envelop:

{  "ok": true,  "capability": "image.generate",  "transport": "local",  "provider": "openai",  "model": "gpt-image-2",  "attempts": [],  "outputs": []}

Stabiele velden op het hoogste niveau:

• ok
• capability
• transport
• provider
• model
• attempts
• inputs (afbeeldingsbijlagen die met de aanvraag zijn verzonden, indien van toepassing)
• outputs
• ignoredOverrides (aanwijzingssleutels die een provider niet ondersteunt, indien van toepassing)
• error

Voor opdrachten die media genereren, bevat outputs bestanden die door OpenClaw zijn geschreven. Gebruik voor automatisering het path, mimeType, size en eventuele mediaspecifieke afmetingen in die array, in plaats van voor mensen leesbare standaarduitvoer te ontleden.

Veelvoorkomende valkuilen

# Badopenclaw infer media image generate --prompt "friendly lobster" # Goodopenclaw infer image generate --prompt "friendly lobster"

# Badopenclaw infer audio transcribe --file ./memo.m4a --model whisper-1 --json # Goodopenclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --json

Gerelateerd

• CLI-referentie
• Modellen