Skip to content

媒體概覽

OpenClaw 可以生成圖像、影片和音樂,理解輸入的媒體(圖像、音訊、影片),並透過文字轉語音大聲朗讀回覆。所有媒體功能均由工具驅動:代理程式會根據對話決定何時使用它們,而每個工具只有在至少設定了一個後端供應商時才會出現。

即時語音使用 Talk 會話合約,而不是一次性媒體工具路徑。Talk 有三種模式:供應商原生 realtime、本機或串流 stt-tts,以及僅用於觀察的語音擷取 transcription。這些模式與電話、會議、瀏覽器即時通訊和原生按鍵通話客戶端共享供應商目錄、事件封包和取消語意。

圖像生成

透過 image_generate,根據文字提示或參考圖片建立與編輯圖片。 在聊天工作階段中為非同步 — 在背景執行,並在準備就緒時發佈結果。

影片生成

透過 video_generate 進行文字轉影片、圖像轉影片以及影片轉影片。 非同步 — 在背景執行並於準備就緒時發佈結果。

音樂生成

透過 music_generate 生成音樂或音訊軌道。在共用的媒體生成任務生命週期中,於聊天工作階段內非同步執行。

文字轉語音

透過 tts 工具加上 messages.tts 設定,將傳出回覆轉換為口語音訊。同步。

媒體理解

使用具備視覺能力的模型供應商和專用的媒體理解外掛,摘要傳入的圖像、音訊和影片。

語音轉文字

透過批次 STT 或語音通話串流 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✓✓✓

功能模式原因
圖片非同步提供者處理時間可長於一個輪次;生成的附件使用共用的完成路徑。
文字轉語音同步提供者回應在幾秒內返回;附加至回覆音訊。
影片非同步提供者處理耗時 30 秒至數分鐘;緩慢的佇列可能會執行直到設定的逾時時間。
音樂非同步提供者處理特性與影片相同。

對於非同步工具,OpenClaw 會向提供商提交請求,立即返回任務 ID,並在任務帳本中追蹤該工作。在工作執行時,代理程式會繼續 回應其他訊息。當提供商完成處理後,OpenClaw 會使用生成的媒體路徑喚醒代理程式,使其能透過會話的一般可見回覆模式告知使用者:若已設定,則自動發送最終回覆,或若會話需要 訊息工具,則使用 message(action="send")。如果請求者的會話處於非活動狀態,或其主動喚醒失敗,且完成回覆中仍缺少部分生成的媒體, OpenClaw 將僅透過等幕直接回退發送缺失的媒體。已透過完成回覆傳送的媒體 不會再次發布。

Deepgram、DeepInfra、ElevenLabs、Mistral、OpenAI、OpenRouter、SenseAudio 和 xAI 均可在設定後透過批次 tools.media.audio 路徑轉錄 輸入音訊。針對提及閘道或指令解析預檢語音訊息的頻道外掛 會在輸入上下文中標記已轉錄的附件,因此共享的 媒體理解流程會重複使用該轉錄結果,而不會針對同一音訊 進行第二次 STT 呼叫。

Deepgram、ElevenLabs、Mistral、OpenAI 和 xAI 也註冊了語音通話串流 STT 提供者,因此即時電話音訊可以在不等待完整錄音的情況下轉發至選定的廠商。

對於即時使用者對話,建議優先使用 Talk 模式。批次音訊 附件保留在媒體路徑上;瀏覽器即時、原生按鍵通話、 電話和會議音訊應使用 Talk 事件以及由 Gateway 返回的會話範圍目錄。

供應商對應(供應商如何跨越不同介面進行分割)

Section titled “供應商對應(供應商如何跨越不同介面進行分割)”
Google

圖像、影片、音樂、批次 TTS、後端即時語音以及 媒體理解介面。

OpenAI

圖像、影片、批次 TTS、批次 STT、語音通話串流 STT、後端 即時語音以及記憶體嵌入介面。

DeepInfra

聊天/模型路由、圖像生成/編輯、文字轉影片、批次 TTS、 批次 STT、圖像媒體理解以及記憶體嵌入介面。 DeepInfra 原生的重排序/分類/物件偵測模型在 OpenClaw 擁有這些類別的專屬供應商合約之前 將不會被註冊。

xAI

圖像、影片、搜尋、程式碼執行、批次 TTS、批次 STT 以及語音 通話串流 STT。xAI 即時語音是一項上游功能,但在 共享的即時語音合約能夠代表它之前, 不會在 OpenClaw 中註冊。