openclaw infer 是提供商支持的推理功能的规范无头接口。它公开的是能力族（model、image、audio、tts、video、web、embedding），而不是原始 Gateway 网关 RPC 名称或智能体工具 ID。openclaw capability ... 是同一命令树的别名。
相比一次性的提供商封装器，优先使用它的原因：
- 复用 OpenClaw 中已配置的提供商和模型。
- 为脚本和智能体驱动的自动化提供稳定的
--json封装（参阅 JSON 输出）。 - 对于大多数子命令，无需 Gateway 网关即可通过常规本地路径运行。
- 对于端到端提供商检查，它会在发出提供商请求前，验证已发布的 CLI、配置加载、默认智能体解析、内置插件激活以及共享能力运行时。
将 infer 转换为技能
将以下内容复制并粘贴给智能体：openclaw infer ... 而非更底层的替代方案，并且不会在技能正文中重新记录整个 infer 接口。
命令树
infer list / infer inspect --name <capability> 将此命令树显示为数据（能力 ID、传输方式、描述）。
常见任务
行为
- 当输出要传给另一个命令或脚本时，使用
--json；否则使用文本输出。 - 使用
--provider或--model provider/model固定特定后端。 - 使用
model run --thinking <level>进行一次性的思考/推理覆盖：off、minimal、low、medium、high、adaptive、xhigh或max。 - 对于
image describe、audio transcribe和video describe，--model必须采用<provider/model>的形式。 - 对于
image describe，--file接受本地路径和 HTTP(S) URL；远程 URL 会经过常规媒体获取 SSRF 策略。 - 无状态执行命令（
model run、image *、audio *、video *、web *、embedding *）默认在本地运行。由 Gateway 网关管理的状态命令（tts status）默认通过 Gateway 网关运行。 - 本地路径从不要求 Gateway 网关正在运行。
- 本地
model run是精简的一次性提供商补全：它会解析已配置的智能体模型和身份验证，但不会启动聊天智能体轮次、加载工具或打开内置 MCP 服务器。 model run --file会将图像文件（自动检测 MIME 类型）附加到提示词；如需附加多张图像，请重复使用--file。非图像文件会被拒绝——请改用infer audio transcribe或infer video describe。model run --gateway会验证 Gateway 网关路由、已保存的身份验证、提供商选择和嵌入式运行时，但仍是原始模型探测：不包含先前的会话记录、引导/AGENTS 上下文、工具或内置 MCP 服务器。model run --gateway --model <provider/model>需要受信任操作员的 Gateway 网关凭据，因为它会要求 Gateway 网关运行一次性的提供商/模型覆盖。
模型
文本推理以及模型/提供商检查。<provider/model> 引用与 --local 配合使用，可在不启动 Gateway 网关或加载智能体工具接口的情况下，对单个提供商执行冒烟测试：
- 本地
model run是用于检查提供商/模型/身份验证健康状况的最精简 CLI 冒烟测试：对于非 ChatGPT-Codex 提供商，它只发送所提供的提示词。 - 本地
model run --model <provider/model>可以在该提供商写入配置前解析内置静态目录中的精确行（即openclaw models list --all显示的相同行）。仍然需要提供商身份验证；凭据缺失会导致身份验证错误，而不是Unknown model。 - 对于 Mistral Medium 3.5 推理探测，请将温度保持为未设置/默认值。Mistral 会以
temperature: 0拒绝reasoning_effort="high"；请使用默认温度或0.7等非零值。 - OpenAI ChatGPT/Codex OAuth（
openai-chatgpt-responsesAPI）本地探测会添加一条最小系统指令，以便传输层填充其必需的instructions字段——不包含完整智能体上下文、工具、记忆或会话记录。 model run --file会将图像内容直接附加到单条用户消息。检测到 MIME 类型为image/*时，常见格式（PNG、JPEG、WebP）可以正常工作；不支持或无法识别的文件会在调用提供商前失败。如果需要 OpenClaw 的图像模型路由和回退，而不是直接的多模态模型探测，请改用infer image describe。- 所选模型必须支持图像输入；纯文本模型可能会在提供商层拒绝该请求。
model run --prompt必须包含非空白文本；空提示词会在调用任何提供商或 Gateway 网关前被拒绝。- 当提供商未返回文本输出时，本地
model run会以非零状态退出，因此无法访问的提供商和空补全不会被误判为成功的探测。 - 使用
model run --gateway测试 Gateway 网关路由或智能体运行时设置，同时保持原始模型输入。使用openclaw agent或聊天接口可获得完整的智能体上下文、工具、记忆和会话记录。 --thinking adaptive映射到补全运行时级别的medium；对于支持原生最大强度的 OpenAI 模型，--thinking max映射到max，否则映射到xhigh。model auth login、model auth logout和model auth status用于管理已保存的提供商身份验证状态。
图像
生成、编辑和描述。-
从现有输入文件开始时使用
image edit；--size、--aspect-ratio或--resolution会在支持它们的提供商/模型上添加几何提示。 -
--output-format png --background transparent与--model openai/gpt-image-1.5搭配使用可生成透明背景的 OpenAI PNG 输出；--openai-background是同一提示的 OpenAI 专用别名。未声明支持背景的提供商会将其报告为已忽略的覆盖项（请参阅 JSON 封装中的ignoredOverrides）。 -
--quality low|medium|high|auto适用于支持图像质量提示的提供商，包括 OpenAI。OpenAI 还接受--openai-moderation low|auto。 -
image providers --json会列出哪些内置图像提供商可被发现、已配置、已选中，以及每个提供商公开的生成/编辑能力。 -
image generate --model <provider/model> --json是针对图像生成更改范围最小的实时冒烟测试：响应会报告ok、provider、model、attempts以及写入的输出路径。设置--output后，最终扩展名可能遵循提供商返回的 MIME 类型。 -
对于
image describe和image describe-many，使用--prompt提供特定于任务的指令（OCR、比较、UI 检查、简洁的说明文字）。 -
对于速度较慢的本地视觉模型或 Ollama 冷启动，请使用
--timeout-ms。 -
对于
image describe，会先运行显式指定的--model（必须是支持图像的<provider/model>），如果该调用失败，则尝试已配置的agents.defaults.imageModel.fallbacks。输入准备错误（文件缺失、不支持的 URL）会在尝试任何回退之前导致失败，并且该模型必须在模型目录或提供商配置中支持图像。 -
对于本地 Ollama 视觉模型，请先拉取模型，并将
OLLAMA_API_KEY设置为任意占位值，例如ollama-local。请参阅 Ollama。
音频
文件转录（不是实时会话管理）。--model 必须是 <provider/model>。
TTS
语音合成以及 TTS 提供商/角色状态。tts status仅支持--gateway（它反映由 Gateway 网关管理的 TTS 状态）。- 使用
tts providers、tts voices、tts personas、tts set-provider和tts set-persona检查并配置 TTS 行为。
视频
生成和描述。video generate接受--size、--aspect-ratio、--resolution、--duration、--audio、--watermark和--timeout-ms，并将其转发给视频生成运行时。- 对于
video describe，--model必须是<provider/model>。
Web
搜索和获取。web providers 会列出用于搜索和获取的可用、已配置和已选中的提供商。
嵌入
向量创建和嵌入提供商检查。JSON 输出
Infer 命令会将 JSON 输出规范化到一个共享封装中：okcapabilitytransportprovidermodelattemptsinputs（随请求发送的图像附件，如适用）outputsignoredOverrides（提供商不支持的提示键，如适用）error
outputs 包含由 OpenClaw 写入的文件。自动化时，请使用该数组中的 path、mimeType、size 以及任何媒体特有的尺寸，而不要解析供人阅读的 stdout。