Skip to main content
OpenClaw 可生成图像、视频和音乐,理解传入媒体 (图像、音频、视频),并通过文本转语音将回复朗读出来。所有 媒体能力都由工具驱动:代理会根据对话决定何时使用它们, 并且每个工具只有在至少配置了一个后端提供商时才会出现。 实时语音使用 Talk 会话契约,而不是一次性媒体工具路径。Talk 有三种模式:提供商原生 realtime、本地或流式 stt-tts,以及用于仅观察式语音采集的 transcription。这些模式与电话、会议、浏览器实时和原生按住说话客户端共享提供商目录、事件封装和取消语义。

功能

图像生成

通过文本提示或参考图像,使用 image_generate 创建和编辑图像。聊天会话中异步运行——在后台运行,并在准备好时发布结果。

视频生成

通过 video_generate 实现文生视频、图生视频和视频转视频。 异步——在后台运行,并在准备好时发布结果。

音乐生成

通过 music_generate 生成音乐或音轨。聊天会话中异步运行,使用共享的媒体生成任务生命周期。

文本转语音

通过 tts 工具加上 messages.tts 配置将外发回复转换为语音音频。同步。

媒体理解

使用具备视觉能力的模型提供商和专用媒体理解插件,对传入的图像、音频和视频进行摘要。

语音转文本

通过批量 STT 或 Voice Call 流式 STT 提供商转录传入的语音消息。

提供商能力矩阵

提供商图像视频音乐TTSSTT实时语音媒体理解
Alibaba
BytePlus
ComfyUI
DeepInfra
Deepgram
ElevenLabs
fal
Google
Gradium
Local CLI
Microsoft
MiniMax
Mistral
OpenAI
OpenRouter
Qwen
Runway
SenseAudio
Together
Vydra
xAI
Xiaomi MiMo
媒体理解使用在你的提供商配置中注册的任何具备视觉能力或音频能力的模型。上面的矩阵列出了具备专用媒体理解支持的提供商;大多数多模态 LLM 提供商(Anthropic、Google、OpenAI 等)在配置为当前回复模型时,也可以理解传入媒体。

异步与同步

能力模式原因
图像异步提供商处理可能会超出一次聊天轮次;生成的附件使用共享完成路径。
文本转语音同步提供商响应会在数秒内返回;附加到回复音频。
视频异步提供商处理需要 30 秒到数分钟;较慢的队列可运行到配置的超时。
音乐异步与视频相同的提供商处理特性。
For async tools, OpenClaw submits the request to the provider, returns a task id immediately, and tracks the job in the task ledger. The agent continues responding to other messages while the job runs. When the provider finishes, OpenClaw wakes the agent with the generated media paths so it can tell the user through the session’s normal visible-reply mode: automatic final reply delivery when configured, or message(action="send") when the session requires the message tool. If the requester session is inactive or its active wake fails, and some generated media is still missing from the completion reply, OpenClaw sends an idempotent direct fallback with only the missing media. Media already delivered by the completion reply is not posted again.

语音转文本与 Voice Call

Deepgram、DeepInfra、ElevenLabs、Mistral、OpenAI、OpenRouter、SenseAudio 和 xAI 在配置后都可以通过批量 tools.media.audio 路径转录 传入音频。 在提及门控或命令 解析前预检语音消息的频道插件,会将转录后的附件标记在传入上下文上,因此共享 媒体理解流程会复用该转录内容,而不是对同一音频再次进行 STT 调用。 Deepgram、ElevenLabs、Mistral、OpenAI 和 xAI 也会注册 Voice Call 流式 STT 提供商,因此实时电话音频可以在无需等待录音完成的情况下 转发给所选 供应商。 对于实时用户对话,请优先使用 Talk 模式。批量音频附件仍保留在媒体路径上;浏览器实时、原生按住说话、电话和会议音频应使用 Talk 事件以及 Gateway 返回的会话作用域目录。

提供商映射(各供应商如何分布在各个表面)

图像、视频、音乐、批量 TTS、后端实时语音,以及 媒体理解相关能力。
图像、视频、批量 TTS、批量 STT、Voice Call 流式 STT、后端 实时语音,以及记忆嵌入相关能力。
聊天/模型路由、图像生成/编辑、文生视频、批量 TTS、 批量 STT、图像媒体理解,以及记忆嵌入相关能力。 在 OpenClaw 拥有这些类别的专用提供商合约之前,DeepInfra 原生的 rerank/classification/object-detection 模型不会注册。
图像、视频、搜索、代码执行、批量 TTS、批量 STT,以及 Voice Call 流式 STT。xAI Realtime 语音是上游能力,但在共享实时语音合约能够表示它之前, 不会在 OpenClaw 中注册。

相关内容