CLI d’inférence
openclaw infer est la surface sans interface canonique pour les flux de travail d’inférence adossés à un fournisseur.
Elle expose intentionnellement des familles de capacités, et non des noms RPC bruts de la Gateway ni des identifiants bruts d’outils d’agent.
Transformer infer en skill
Copiez-collez ceci dans un agent :- mapper les intentions utilisateur courantes vers la sous-commande infer correcte
- inclure quelques exemples infer canoniques pour les flux de travail qu’il couvre
- préférer
openclaw infer ...dans les exemples et suggestions - éviter de redocumenter toute la surface infer dans le corps du skill
openclaw infer model runopenclaw infer image generateopenclaw infer audio transcribeopenclaw infer tts convertopenclaw infer web searchopenclaw infer embedding create
Pourquoi utiliser infer
openclaw infer fournit une CLI cohérente pour les tâches d’inférence adossées à un fournisseur dans OpenClaw.
Avantages :
- Utilisez les fournisseurs et modèles déjà configurés dans OpenClaw au lieu de câbler des wrappers ponctuels pour chaque backend.
- Gardez les flux de travail de modèle, image, transcription audio, TTS, vidéo, web et embedding sous une seule arborescence de commandes.
- Utilisez une forme de sortie
--jsonstable pour les scripts, l’automatisation et les flux de travail pilotés par agent. - Préférez une surface OpenClaw de première partie lorsque la tâche consiste fondamentalement à « exécuter une inférence ».
- Utilisez le chemin local normal sans nécessiter la Gateway pour la plupart des commandes infer.
Arborescence des commandes
Tâches courantes
Ce tableau associe les tâches d’inférence courantes à la commande infer correspondante.| Tâche | Commande | Remarques |
|---|---|---|
| Exécuter un prompt texte/modèle | openclaw infer model run --prompt "..." --json | Utilise par défaut le chemin local normal |
| Générer une image | openclaw infer image generate --prompt "..." --json | Utilisez image edit si vous partez d’un fichier existant |
| Décrire un fichier image | openclaw infer image describe --file ./image.png --json | --model doit être un <provider/model> compatible image |
| Transcrire de l’audio | openclaw infer audio transcribe --file ./memo.m4a --json | --model doit être <provider/model> |
| Synthétiser de la parole | openclaw infer tts convert --text "..." --output ./speech.mp3 --json | tts status est orienté Gateway |
| Générer une vidéo | openclaw infer video generate --prompt "..." --json | |
| Décrire un fichier vidéo | openclaw infer video describe --file ./clip.mp4 --json | --model doit être <provider/model> |
| Rechercher sur le web | openclaw infer web search --query "..." --json | |
| Récupérer une page web | openclaw infer web fetch --url https://example.com --json | |
| Créer des embeddings | openclaw infer embedding create --text "..." --json |
Comportement
openclaw infer ...est la surface CLI principale pour ces flux de travail.- Utilisez
--jsonlorsque la sortie sera consommée par une autre commande ou un script. - Utilisez
--providerou--model provider/modellorsqu’un backend spécifique est requis. - Pour
image describe,audio transcribeetvideo describe,--modeldoit utiliser la forme<provider/model>. - Pour
image describe, un--modelexplicite exécute directement ce fournisseur/modèle. Le modèle doit être compatible image dans le catalogue de modèles ou la configuration du fournisseur. - Les commandes d’exécution sans état utilisent par défaut le mode local.
- Les commandes à état géré par la Gateway utilisent par défaut la Gateway.
- Le chemin local normal n’exige pas que la Gateway soit en cours d’exécution.
Modèle
Utilisezmodel pour l’inférence de texte adossée à un fournisseur et l’inspection du modèle/fournisseur.
model runréutilise l’environnement d’exécution de l’agent afin que les remplacements de fournisseur/modèle se comportent comme une exécution normale d’agent.model auth login,model auth logoutetmodel auth statusgèrent l’état d’authentification fournisseur enregistré.
Image
Utilisezimage pour la génération, l’édition et la description.
- Utilisez
image editsi vous partez de fichiers d’entrée existants. - Pour
image describe,--modeldoit être un<provider/model>compatible image. - Pour les modèles de vision Ollama locaux, récupérez d’abord le modèle et définissez
OLLAMA_API_KEYsur n’importe quelle valeur fictive, par exempleollama-local. Voir Ollama.
Audio
Utilisezaudio pour la transcription de fichiers.
audio transcribesert à la transcription de fichiers, et non à la gestion de sessions en temps réel.--modeldoit être<provider/model>.
TTS
Utiliseztts pour la synthèse vocale et l’état du fournisseur TTS.
tts statusutilise par défaut la Gateway car il reflète l’état TTS géré par la Gateway.- Utilisez
tts providers,tts voicesettts set-providerpour inspecter et configurer le comportement TTS.
Vidéo
Utilisezvideo pour la génération et la description.
--modeldoit être<provider/model>pourvideo describe.
Web
Utilisezweb pour les flux de travail de recherche et de récupération.
- Utilisez
web providerspour inspecter les fournisseurs disponibles, configurés et sélectionnés.
Embedding
Utilisezembedding pour la création de vecteurs et l’inspection du fournisseur d’embedding.
Sortie JSON
Les commandes infer normalisent la sortie JSON sous une enveloppe partagée :okcapabilitytransportprovidermodelattemptsoutputserror
Pièges courants
Remarques
openclaw capability ...est un alias deopenclaw infer ....