Tools
Chuyển văn bản thành giọng nói
OpenClaw có thể chuyển đổi các phản hồi gửi đi thành âm thanh qua 14 nhà cung cấp giọng nói và gửi tin nhắn thoại gốc trên Feishu, Matrix, Telegram và WhatsApp, tệp đính kèm âm thanh ở mọi nơi khác, và luồng PCM/Ulaw cho điện thoại và Talk.
TTS là nửa đầu ra giọng nói của chế độ stt-tts trong Talk. Các phiên Talk
realtime gốc của nhà cung cấp sẽ tổng hợp giọng nói bên trong nhà cung cấp thời gian thực
thay vì gọi đường dẫn TTS này, còn các phiên transcription không tổng hợp
phản hồi giọng nói của trợ lý.
Bắt đầu nhanh
Chọn nhà cung cấp
OpenAI và ElevenLabs là các lựa chọn được lưu trữ đáng tin cậy nhất. Microsoft và Local CLI hoạt động mà không cần khóa API. Xem ma trận nhà cung cấp để biết danh sách đầy đủ.
Đặt khóa API
Xuất biến môi trường cho nhà cung cấp của bạn (ví dụ OPENAI_API_KEY,
ELEVENLABS_API_KEY). Microsoft và Local CLI không cần khóa.
Bật trong cấu hình
Đặt messages.tts.auto: "always" và messages.tts.provider:
{ messages: { tts: { auto: "always", provider: "elevenlabs", }, },}Thử trong trò chuyện
/tts status hiển thị trạng thái hiện tại. /tts audio Hello from OpenClaw
gửi một phản hồi âm thanh dùng một lần.
Nhà cung cấp được hỗ trợ
| Nhà cung cấp | Xác thực | Ghi chú |
|---|---|---|
| Azure Speech | AZURE_SPEECH_KEY + AZURE_SPEECH_REGION (cũng có AZURE_SPEECH_API_KEY, SPEECH_KEY, SPEECH_REGION) |
Đầu ra ghi chú thoại Ogg/Opus gốc và điện thoại. |
| DeepInfra | DEEPINFRA_API_KEY |
TTS tương thích OpenAI. Mặc định là hexgrad/Kokoro-82M. |
| ElevenLabs | ELEVENLABS_API_KEY hoặc XI_API_KEY |
Nhân bản giọng nói, đa ngôn ngữ, xác định qua seed; được truyền phát cho phát lại giọng nói Discord. |
| Google Gemini | GEMINI_API_KEY hoặc GOOGLE_API_KEY |
TTS theo lô của API Gemini; nhận biết persona qua promptTemplate: "audio-profile-v1". |
| Gradium | GRADIUM_API_KEY |
Đầu ra ghi chú thoại và điện thoại. |
| Inworld | INWORLD_API_KEY |
API TTS truyền phát. Ghi chú thoại Opus gốc và điện thoại PCM. |
| Local CLI | không có | Chạy một lệnh TTS cục bộ đã cấu hình. |
| Microsoft | không có | TTS neural Edge công khai qua node-edge-tts. Nỗ lực tối đa, không có SLA. |
| MiniMax | MINIMAX_API_KEY (hoặc Token Plan: MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) |
API T2A v2. Mặc định là speech-2.8-hd. |
| OpenAI | OPENAI_API_KEY |
Cũng dùng cho tự động tóm tắt; hỗ trợ persona instructions. |
| OpenRouter | OPENROUTER_API_KEY (có thể dùng lại models.providers.openrouter.apiKey) |
Mô hình mặc định hexgrad/kokoro-82m. |
| Volcengine | VOLCENGINE_TTS_API_KEY hoặc BYTEPLUS_SEED_SPEECH_API_KEY (AppID/token cũ: VOLCENGINE_TTS_APPID/_TOKEN) |
API HTTP BytePlus Seed Speech. |
| Vydra | VYDRA_API_KEY |
Nhà cung cấp hình ảnh, video và giọng nói dùng chung. |
| xAI | XAI_API_KEY |
TTS theo lô của xAI. Ghi chú thoại Opus gốc không được hỗ trợ. |
| Xiaomi MiMo | XIAOMI_API_KEY |
TTS MiMo thông qua hoàn tất trò chuyện của Xiaomi. |
Nếu nhiều nhà cung cấp được cấu hình, nhà cung cấp đã chọn sẽ được dùng trước và
các nhà cung cấp khác là tùy chọn dự phòng. Tự động tóm tắt dùng summaryModel (hoặc
agents.defaults.model.primary), vì vậy nhà cung cấp đó cũng phải được xác thực
nếu bạn tiếp tục bật tóm tắt.
Cấu hình
Cấu hình TTS nằm dưới messages.tts trong ~/.openclaw/openclaw.json. Chọn một
preset và điều chỉnh khối nhà cung cấp:
Azure Speech
{messages: {tts: { auto: "always", provider: "azure-speech", providers: { "azure-speech": { apiKey: "${AZURE_SPEECH_KEY}", region: "eastus", voice: "en-US-JennyNeural", lang: "en-US", outputFormat: "audio-24khz-48kbitrate-mono-mp3", voiceNoteOutputFormat: "ogg-24khz-16bit-mono-opus", }, },},},}ElevenLabs
{messages: {tts: { auto: "always", provider: "elevenlabs", providers: { elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2", voiceId: "EXAVITQu4vr4xnSDxMaL", }, },},},}Google Gemini
{messages: {tts: { auto: "always", provider: "google", providers: { google: { apiKey: "${GEMINI_API_KEY}", model: "gemini-3.1-flash-tts-preview", voiceName: "Kore", // Optional natural-language style prompts: // audioProfile: "Speak in a calm, podcast-host tone.", // speakerName: "Alex", }, },},},}Gradium
{messages: {tts: { auto: "always", provider: "gradium", providers: { gradium: { apiKey: "${GRADIUM_API_KEY}", voiceId: "YTpq7expH9539ERJ", }, },},},}Inworld
{messages: {tts: { auto: "always", provider: "inworld", providers: { inworld: { apiKey: "${INWORLD_API_KEY}", modelId: "inworld-tts-1.5-max", voiceId: "Sarah", temperature: 0.7, }, },},},}Local CLI
{messages: {tts: { auto: "always", provider: "tts-local-cli", providers: { "tts-local-cli": { command: "say", args: ["-o", "{{OutputPath}}", "{{Text}}"], outputFormat: "wav", timeoutMs: 120000, }, },},},}Microsoft (không cần khóa)
{messages: {tts: { auto: "always", provider: "microsoft", providers: { microsoft: { enabled: true, voice: "en-US-MichelleNeural", lang: "en-US", outputFormat: "audio-24khz-48kbitrate-mono-mp3", rate: "+0%", pitch: "+0%", }, },},},}MiniMax
{messages: {tts: { auto: "always", provider: "minimax", providers: { minimax: { apiKey: "${MINIMAX_API_KEY}", model: "speech-2.8-hd", voiceId: "English_expressive_narrator", speed: 1.0, vol: 1.0, pitch: 0, }, },},},}OpenAI + ElevenLabs
{messages: {tts: { auto: "always", provider: "openai", summaryModel: "openai/gpt-4.1-mini", modelOverrides: { enabled: true }, providers: { openai: { apiKey: "${OPENAI_API_KEY}", model: "gpt-4o-mini-tts", voice: "alloy", }, elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2", voiceId: "EXAVITQu4vr4xnSDxMaL", voiceSettings: { stability: 0.5, similarityBoost: 0.75, style: 0.0, useSpeakerBoost: true, speed: 1.0 }, applyTextNormalization: "auto", languageCode: "en", }, },},},}OpenRouter
{messages: {tts: { auto: "always", provider: "openrouter", providers: { openrouter: { apiKey: "${OPENROUTER_API_KEY}", model: "hexgrad/kokoro-82m", voice: "af_alloy", responseFormat: "mp3", }, },},},}Volcengine
{messages: {tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "${VOLCENGINE_TTS_API_KEY}", resourceId: "seed-tts-1.0", voice: "en_female_anna_mars_bigtts", }, },},},}xAI
{messages: {tts: { auto: "always", provider: "xai", providers: { xai: { apiKey: "${XAI_API_KEY}", voiceId: "eve", language: "en", responseFormat: "mp3", }, },},},}Xiaomi MiMo
{messages: {tts: { auto: "always", provider: "xiaomi", providers: { xiaomi: { apiKey: "${XIAOMI_API_KEY}", model: "mimo-v2.5-tts", voice: "mimo_default", format: "mp3", }, },},},}Ghi đè giọng nói theo từng agent
Dùng agents.list[].tts khi một agent cần nói bằng nhà cung cấp, giọng nói,
mô hình, persona hoặc chế độ Auto-TTS khác. Khối agent được trộn sâu lên trên
messages.tts, vì vậy thông tin xác thực nhà cung cấp có thể nằm trong cấu hình nhà cung cấp toàn cục:
{ messages: { tts: { auto: "always", provider: "elevenlabs", providers: { elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2" }, }, }, }, agents: { list: [ { id: "reader", tts: { providers: { elevenlabs: { voiceId: "EXAVITQu4vr4xnSDxMaL" }, }, }, }, ], },}Để ghim một persona theo từng agent, hãy đặt agents.list[].tts.persona cùng với
cấu hình nhà cung cấp — nó chỉ ghi đè messages.tts.persona toàn cục cho agent đó.
Thứ tự ưu tiên cho trả lời tự động, /tts audio, /tts status và công cụ agent
tts:
messages.ttsagents.list[].ttsđang hoạt động- ghi đè kênh, khi kênh hỗ trợ
channels.<channel>.tts - ghi đè tài khoản, khi kênh truyền
channels.<channel>.accounts.<id>.tts - tùy chọn
/ttscục bộ cho máy chủ này - chỉ thị nội tuyến
[[tts:...]]khi bật ghi đè theo mô hình
Ghi đè kênh và tài khoản dùng cùng cấu trúc với messages.tts và
hợp nhất sâu lên các lớp trước đó, để thông tin xác thực nhà cung cấp dùng chung
có thể nằm trong messages.tts trong khi một kênh hoặc tài khoản bot chỉ thay đổi
giọng nói, mô hình, persona hoặc chế độ tự động:
{ messages: { tts: { provider: "openai", providers: { openai: { apiKey: "${OPENAI_API_KEY}", model: "gpt-4o-mini-tts" }, }, }, }, channels: { feishu: { accounts: { english: { tts: { providers: { openai: { voice: "shimmer" }, }, }, }, }, }, },}Persona
Một persona là một danh tính giọng nói ổn định có thể được áp dụng một cách xác định trên nhiều nhà cung cấp. Nó có thể ưu tiên một nhà cung cấp, định nghĩa ý định prompt trung lập với nhà cung cấp, và mang các liên kết riêng theo nhà cung cấp cho giọng nói, mô hình, mẫu prompt, seed và cài đặt giọng nói.
Persona tối thiểu
{ messages: { tts: { auto: "always", persona: "narrator", personas: { narrator: { label: "Narrator", provider: "elevenlabs", providers: { elevenlabs: { voiceId: "EXAVITQu4vr4xnSDxMaL", modelId: "eleven_multilingual_v2" }, }, }, }, }, },}Persona đầy đủ (prompt trung lập với nhà cung cấp)
{ messages: { tts: { auto: "always", persona: "alfred", personas: { alfred: { label: "Alfred", description: "Dry, warm British butler narrator.", provider: "google", fallbackPolicy: "preserve-persona", prompt: { profile: "A brilliant British butler. Dry, witty, warm, charming, emotionally expressive, never generic.", scene: "A quiet late-night study. Close-mic narration for a trusted operator.", sampleContext: "The speaker is answering a private technical request with concise confidence and dry warmth.", style: "Refined, understated, lightly amused.", accent: "British English.", pacing: "Measured, with short dramatic pauses.", constraints: ["Do not read configuration values aloud.", "Do not explain the persona."], }, providers: { google: { model: "gemini-3.1-flash-tts-preview", voiceName: "Algieba", promptTemplate: "audio-profile-v1", }, openai: { model: "gpt-4o-mini-tts", voice: "cedar" }, elevenlabs: { voiceId: "voice_id", modelId: "eleven_multilingual_v2", seed: 42, voiceSettings: { stability: 0.65, similarityBoost: 0.8, style: 0.25, useSpeakerBoost: true, speed: 0.95, }, }, }, }, }, }, },}Phân giải persona
Persona đang hoạt động được chọn một cách xác định:
- tùy chọn cục bộ
/tts persona <id>, nếu đã đặt. messages.tts.persona, nếu đã đặt.- Không có persona.
Việc chọn nhà cung cấp chạy theo thứ tự ưu tiên lựa chọn tường minh:
- Ghi đè trực tiếp (CLI, gateway, Talk, các chỉ thị TTS được phép).
- tùy chọn cục bộ
/tts provider <id>. providercủa persona đang hoạt động.messages.tts.provider.- Tự động chọn từ registry.
Với mỗi lần thử nhà cung cấp, OpenClaw hợp nhất cấu hình theo thứ tự này:
messages.tts.providers.<id>messages.tts.personas.<persona>.providers.<id>- Ghi đè yêu cầu đáng tin cậy
- Ghi đè từ chỉ thị TTS do mô hình phát ra và được phép
Cách nhà cung cấp dùng prompt persona
Các trường prompt persona (profile, scene, sampleContext, style, accent,
pacing, constraints) là trung lập với nhà cung cấp. Mỗi nhà cung cấp quyết định
cách dùng chúng:
Google Gemini
Bọc các trường prompt persona trong cấu trúc prompt Gemini TTS chỉ khi
cấu hình nhà cung cấp Google hiệu dụng đặt promptTemplate: "audio-profile-v1"
hoặc personaPrompt. Các trường cũ hơn audioProfile và speakerName vẫn
được thêm vào đầu dưới dạng văn bản prompt riêng cho Google. Các thẻ âm thanh nội tuyến như
[whispers] hoặc [laughs] bên trong khối [[tts:text]] được giữ nguyên
trong bản chép lời Gemini; OpenClaw không tạo các thẻ này.
OpenAI
Ánh xạ các trường prompt persona vào trường yêu cầu instructions chỉ khi
chưa cấu hình instructions tường minh cho OpenAI. instructions tường minh
luôn thắng.
Nhà cung cấp khác
Chỉ dùng các liên kết persona riêng theo nhà cung cấp bên dưới
personas.<id>.providers.<provider>. Các trường prompt persona bị bỏ qua
trừ khi nhà cung cấp triển khai ánh xạ persona-prompt riêng.
Chính sách dự phòng
fallbackPolicy kiểm soát hành vi khi một persona không có liên kết cho
nhà cung cấp được thử:
| Chính sách | Hành vi |
|---|---|
preserve-persona |
Mặc định. Các trường prompt trung lập với nhà cung cấp vẫn khả dụng; nhà cung cấp có thể dùng hoặc bỏ qua chúng. |
provider-defaults |
Persona bị bỏ qua khỏi bước chuẩn bị prompt cho lần thử đó; nhà cung cấp dùng mặc định trung lập của mình trong khi tiếp tục dự phòng sang nhà cung cấp khác. |
fail |
Bỏ qua lần thử nhà cung cấp đó với reasonCode: "not_configured" và personaBinding: "missing". Các nhà cung cấp dự phòng vẫn được thử. |
Toàn bộ yêu cầu TTS chỉ thất bại khi mọi nhà cung cấp được thử đều bị bỏ qua hoặc thất bại.
Việc chọn nhà cung cấp cho phiên Talk có phạm vi theo phiên. Một client Talk nên chọn
id nhà cung cấp, id mô hình, id giọng nói và locale từ talk.catalog rồi truyền
chúng qua phiên Talk hoặc yêu cầu bàn giao. Việc mở một phiên thoại không nên
thay đổi messages.tts hoặc các mặc định nhà cung cấp Talk toàn cục.
Chỉ thị do mô hình điều khiển
Theo mặc định, trợ lý có thể phát ra các chỉ thị [[tts:...]] để ghi đè
giọng nói, mô hình hoặc tốc độ cho một câu trả lời duy nhất, cùng với một khối
[[tts:text]]...[[/tts:text]] tùy chọn cho các gợi ý biểu cảm chỉ nên xuất hiện
trong âm thanh:
Here you go. [[tts:voiceId=pMsXgVXv3BLzUgSXRplE model=eleven_v3 speed=1.1]][[tts:text]](laughs) Read the song once more.[[/tts:text]]Khi messages.tts.auto là "tagged", bắt buộc có chỉ thị để kích hoạt
âm thanh. Việc phân phối khối streaming loại bỏ chỉ thị khỏi văn bản hiển thị trước khi
kênh nhìn thấy chúng, ngay cả khi chúng bị tách qua các khối liền kề.
provider=... bị bỏ qua trừ khi modelOverrides.allowProvider: true. Khi một
câu trả lời khai báo provider=..., các khóa khác trong chỉ thị đó chỉ được phân tích
bởi nhà cung cấp đó; các khóa không được hỗ trợ sẽ bị loại bỏ và được báo cáo dưới dạng
cảnh báo chỉ thị TTS.
Các khóa chỉ thị khả dụng:
provider(id nhà cung cấp đã đăng ký; yêu cầuallowProvider: true)voice/voiceName/voice_name/google_voice/voiceIdmodel/google_modelstability,similarityBoost,style,speed,useSpeakerBoostvol/volume(âm lượng MiniMax, 0–10)pitch(cao độ số nguyên MiniMax, −12 đến 12; giá trị thập phân bị cắt bỏ phần lẻ)emotion(thẻ cảm xúc Volcengine)applyTextNormalization(auto|on|off)languageCode(ISO 639-1)seed
Tắt hoàn toàn ghi đè mô hình:
{ messages: { tts: { modelOverrides: { enabled: false } } } }Cho phép chuyển đổi nhà cung cấp trong khi vẫn giữ các nút điều chỉnh khác có thể cấu hình:
{ messages: { tts: { modelOverrides: { enabled: true, allowProvider: true, allowSeed: false } } } }Lệnh dấu gạch chéo
Một lệnh duy nhất /tts. Trên Discord, OpenClaw cũng đăng ký /voice vì
/tts là một lệnh tích hợp sẵn của Discord — văn bản /tts ... vẫn hoạt động.
/tts off | on | status/tts chat on | off | default/tts latest/tts provider <id>/tts persona <id> | off/tts limit <chars>/tts summary off/tts audio <text>Ghi chú hành vi:
/tts onghi tùy chọn TTS cục bộ thànhalways;/tts offghi thànhoff./tts chat on|off|defaultghi một ghi đè auto-TTS theo phạm vi phiên cho cuộc trò chuyện hiện tại./tts persona <id>ghi tùy chọn persona cục bộ;/tts persona offxóa tùy chọn đó./tts latestđọc câu trả lời trợ lý mới nhất từ bản ghi phiên hiện tại và gửi nó dưới dạng âm thanh một lần. Nó chỉ lưu một hash của câu trả lời đó trên mục phiên để ngăn gửi giọng nói trùng lặp./tts audiotạo một câu trả lời âm thanh một lần (không bật TTS).limitvàsummaryđược lưu trong tùy chọn cục bộ, không phải cấu hình chính./tts statusbao gồm chẩn đoán dự phòng cho lần thử mới nhất —Fallback: <primary> -> <used>,Attempts: ..., và chi tiết từng lần thử (provider:outcome(reasonCode) latency)./statushiển thị chế độ TTS đang hoạt động cùng nhà cung cấp, mô hình, giọng nói đã cấu hình và siêu dữ liệu endpoint tùy chỉnh đã được làm sạch khi TTS được bật.
Tùy chọn theo người dùng
Các lệnh dấu gạch chéo ghi ghi đè cục bộ vào prefsPath. Mặc định là
~/.openclaw/settings/tts.json; ghi đè bằng biến môi trường OPENCLAW_TTS_PREFS
hoặc messages.tts.prefsPath.
| Trường đã lưu | Tác động |
|---|---|
auto |
Ghi đè auto-TTS cục bộ (always, off, …) |
provider |
Ghi đè nhà cung cấp chính cục bộ |
persona |
Ghi đè persona cục bộ |
maxLength |
Ngưỡng tóm tắt (mặc định 1500 ký tự) |
summarize |
Công tắc tóm tắt (mặc định true) |
Những giá trị này ghi đè cấu hình hiệu dụng từ messages.tts cộng với khối
agents.list[].tts đang hoạt động cho máy chủ đó.
Định dạng đầu ra (cố định)
Việc phân phối giọng nói TTS được điều khiển bởi capability của kênh. Các Plugin kênh quảng bá
liệu TTS kiểu tin nhắn thoại có nên yêu cầu nhà cung cấp tạo mục tiêu voice-note gốc hay
giữ tổng hợp audio-file bình thường và chỉ đánh dấu đầu ra tương thích để phân phối
dưới dạng giọng nói.
- Các kênh hỗ trợ tin nhắn thoại: phản hồi bằng tin nhắn thoại ưu tiên Opus (
opus_48000_64từ ElevenLabs,opustừ OpenAI).- 48kHz / 64kbps là mức đánh đổi tốt cho tin nhắn thoại.
- Feishu / WhatsApp: khi phản hồi bằng tin nhắn thoại được tạo dưới dạng MP3/WebM/WAV/M4A
hoặc một tệp có nhiều khả năng là âm thanh khác, Plugin kênh sẽ chuyển mã tệp đó sang Ogg/Opus
48kHz bằng
ffmpegtrước khi gửi tin nhắn thoại gốc. WhatsApp gửi kết quả qua payloadaudiocủa Baileys vớiptt: truevàaudio/ogg; codecs=opus. Nếu chuyển đổi thất bại, Feishu nhận tệp gốc dưới dạng tệp đính kèm; WhatsApp gửi thất bại thay vì đăng payload PTT không tương thích. - Các kênh khác: MP3 (
mp3_44100_128từ ElevenLabs,mp3từ OpenAI).- 44.1kHz / 128kbps là mức cân bằng mặc định cho độ rõ của giọng nói.
- MiniMax: MP3 (mô hình
speech-2.8-hd, tần số lấy mẫu 32kHz) cho tệp đính kèm âm thanh thông thường. Với các mục tiêu tin nhắn thoại do kênh công bố, OpenClaw chuyển mã MP3 của MiniMax sang Opus 48kHz bằngffmpegtrước khi phân phối khi kênh công bố khả năng chuyển mã. - Xiaomi MiMo: mặc định là MP3, hoặc WAV khi được cấu hình. Với các mục tiêu tin nhắn thoại do kênh công bố, OpenClaw chuyển mã đầu ra của Xiaomi sang Opus 48kHz bằng
ffmpegtrước khi phân phối khi kênh công bố khả năng chuyển mã. - CLI cục bộ: sử dụng
outputFormatđã cấu hình. Các mục tiêu tin nhắn thoại được chuyển đổi sang Ogg/Opus và đầu ra điện thoại được chuyển đổi sang PCM mono 16 kHz thô bằngffmpeg. - Google Gemini: TTS của Gemini API trả về PCM 24kHz thô. OpenClaw bọc nó dưới dạng WAV cho tệp đính kèm âm thanh, chuyển mã nó sang Opus 48kHz cho mục tiêu tin nhắn thoại, và trả về PCM trực tiếp cho Talk/điện thoại.
- Gradium: WAV cho tệp đính kèm âm thanh, Opus cho mục tiêu tin nhắn thoại, và
ulaw_8000ở 8 kHz cho điện thoại. - Inworld: MP3 cho tệp đính kèm âm thanh thông thường,
OGG_OPUSgốc cho mục tiêu tin nhắn thoại, vàPCMthô ở 22050 Hz cho Talk/điện thoại. - xAI: mặc định là MP3;
responseFormatcó thể làmp3,wav,pcm,mulaw, hoặcalaw. OpenClaw sử dụng endpoint TTS REST batch của xAI và trả về một tệp đính kèm âm thanh hoàn chỉnh; WebSocket TTS phát trực tuyến của xAI không được đường dẫn nhà cung cấp này sử dụng. Định dạng tin nhắn thoại Opus gốc không được đường dẫn này hỗ trợ. - Microsoft: sử dụng
microsoft.outputFormat(mặc địnhaudio-24khz-48kbitrate-mono-mp3).- Transport đi kèm chấp nhận
outputFormat, nhưng không phải tất cả định dạng đều có sẵn từ dịch vụ. - Giá trị định dạng đầu ra tuân theo các định dạng đầu ra Microsoft Speech (bao gồm Ogg/WebM Opus).
sendVoicecủa Telegram chấp nhận OGG/MP3/M4A; hãy dùng OpenAI/ElevenLabs nếu bạn cần tin nhắn thoại Opus được đảm bảo.- Nếu định dạng đầu ra Microsoft đã cấu hình thất bại, OpenClaw thử lại bằng MP3.
- Transport đi kèm chấp nhận
Định dạng đầu ra OpenAI/ElevenLabs được cố định theo từng kênh (xem ở trên).
Hành vi Auto-TTS
Khi messages.tts.auto được bật, OpenClaw:
- Bỏ qua TTS nếu phản hồi đã chứa phương tiện hoặc chỉ thị
MEDIA:. - Bỏ qua các phản hồi rất ngắn (dưới 10 ký tự).
- Tóm tắt các phản hồi dài khi tóm tắt được bật, bằng cách sử dụng
summaryModel(hoặcagents.defaults.model.primary). - Đính kèm âm thanh đã tạo vào phản hồi.
- Trong
mode: "final", vẫn gửi TTS chỉ có âm thanh cho các phản hồi cuối được phát trực tuyến sau khi luồng văn bản hoàn tất; phương tiện đã tạo đi qua cùng quy trình chuẩn hóa phương tiện của kênh như các tệp đính kèm phản hồi thông thường.
Nếu phản hồi vượt quá maxLength và tóm tắt bị tắt (hoặc không có khóa API cho
mô hình tóm tắt), âm thanh sẽ bị bỏ qua và phản hồi văn bản thông thường được gửi.
Reply -> TTS enabled? no -> send text yes -> has media / MEDIA: / short? yes -> send text no -> length > limit? no -> TTS -> attach audio yes -> summary enabled? no -> send text yes -> summarize -> TTS -> attach audioĐịnh dạng đầu ra theo kênh
| Mục tiêu | Định dạng |
|---|---|
| Feishu / Matrix / Telegram / WhatsApp | Phản hồi ghi âm thoại ưu tiên Opus (opus_48000_64 từ ElevenLabs, opus từ OpenAI). 48 kHz / 64 kbps cân bằng độ rõ và kích thước. |
| Các kênh khác | MP3 (mp3_44100_128 từ ElevenLabs, mp3 từ OpenAI). 44.1 kHz / 128 kbps là mặc định cho giọng nói. |
| Talk / điện thoại | PCM gốc của nhà cung cấp (Inworld 22050 Hz, Google 24 kHz), hoặc ulaw_8000 từ Gradium cho điện thoại. |
Ghi chú theo từng nhà cung cấp:
- Chuyển mã Feishu / WhatsApp: Khi phản hồi ghi âm thoại đến dưới dạng MP3/WebM/WAV/M4A, Plugin kênh chuyển mã sang Ogg/Opus 48 kHz bằng
ffmpeg. WhatsApp gửi qua Baileys vớiptt: truevàaudio/ogg; codecs=opus. Nếu chuyển đổi thất bại: Feishu quay về đính kèm tệp gốc; WhatsApp gửi thất bại thay vì đăng một payload PTT không tương thích. - MiniMax / Xiaomi MiMo: MP3 mặc định (32 kHz cho MiniMax
speech-2.8-hd); được chuyển mã sang Opus 48 kHz cho mục tiêu ghi âm thoại quaffmpeg. - CLI cục bộ: Sử dụng
outputFormatđã cấu hình. Mục tiêu ghi âm thoại được chuyển đổi sang Ogg/Opus và đầu ra điện thoại sang PCM mono 16 kHz thô. - Google Gemini: Trả về PCM 24 kHz thô. OpenClaw bọc thành WAV cho tệp đính kèm, chuyển mã sang Opus 48 kHz cho mục tiêu ghi âm thoại, trả về PCM trực tiếp cho Talk/điện thoại.
- Inworld: Tệp đính kèm MP3, ghi âm thoại
OGG_OPUSgốc,PCMthô 22050 Hz cho Talk/điện thoại. - xAI: MP3 theo mặc định;
responseFormatcó thể làmp3|wav|pcm|mulaw|alaw. Sử dụng endpoint REST theo lô của xAI — TTS WebSocket phát trực tuyến không được sử dụng. Định dạng ghi âm thoại Opus gốc không được hỗ trợ. - Microsoft: Sử dụng
microsoft.outputFormat(mặc địnhaudio-24khz-48kbitrate-mono-mp3).sendVoicecủa Telegram chấp nhận OGG/MP3/M4A; dùng OpenAI/ElevenLabs nếu bạn cần bảo đảm tin nhắn thoại Opus. Nếu định dạng Microsoft đã cấu hình thất bại, OpenClaw thử lại bằng MP3.
Định dạng đầu ra OpenAI và ElevenLabs được cố định theo từng kênh như liệt kê ở trên.
Tham chiếu trường
messages.tts.* cấp cao nhất
auto"off" | "always" | "inbound" | "tagged"Chế độ Auto-TTS. inbound chỉ gửi âm thanh sau một tin nhắn thoại đến; tagged chỉ gửi âm thanh khi phản hồi bao gồm các chỉ thị [[tts:...]] hoặc một khối [[tts:text]].
enabledbooleanCông tắc kế thừa. openclaw doctor --fix di chuyển giá trị này sang auto.
mode"final" | "all"default: final"all" bao gồm phản hồi công cụ/khối ngoài các phản hồi cuối cùng.
providerstringID nhà cung cấp giọng nói. Khi không đặt, OpenClaw dùng nhà cung cấp đầu tiên đã cấu hình theo thứ tự tự động chọn của registry. provider: "edge" kế thừa được openclaw doctor --fix viết lại thành "microsoft".
personastringID persona đang hoạt động từ personas. Được chuẩn hóa thành chữ thường.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InBlcnNvbmFzLjxpZA
" type="object">
Danh tính nói ổn định. Trường: label, description, provider, fallbackPolicy, prompt, providers.<provider>. Xem Personas.
summaryModelstringMô hình rẻ cho tự động tóm tắt; mặc định là agents.defaults.model.primary. Chấp nhận provider/model hoặc một bí danh mô hình đã cấu hình.
modelOverridesobjectCho phép mô hình phát ra chỉ thị TTS. enabled mặc định là true; allowProvider mặc định là false.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InByb3ZpZGVycy48aWQ
" type="object">
Cài đặt do nhà cung cấp sở hữu, được khóa theo ID nhà cung cấp giọng nói. Các khối trực tiếp kế thừa (messages.tts.openai, .elevenlabs, .microsoft, .edge) được openclaw doctor --fix viết lại; chỉ commit messages.tts.providers.<id>.
maxTextLengthnumberGiới hạn cứng cho số ký tự đầu vào TTS. /tts audio thất bại nếu vượt quá.
timeoutMsnumberThời gian chờ yêu cầu tính bằng mili giây.
prefsPathstringGhi đè đường dẫn JSON tùy chọn cục bộ (nhà cung cấp/giới hạn/tóm tắt). Mặc định ~/.openclaw/settings/tts.json.
Azure Speech
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: AZURE_SPEECH_KEY, AZURE_SPEECH_API_KEY, hoặc SPEECH_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlZ2lvbiIgdHlwZT0ic3RyaW5nIg
Vùng Azure Speech (ví dụ eastus). Env: AZURE_SPEECH_REGION hoặc SPEECH_REGION.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImVuZHBvaW50IiB0eXBlPSJzdHJpbmci
Ghi đè endpoint Azure Speech tùy chọn (bí danh baseUrl).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
ShortName giọng nói Azure. Mặc định en-US-JennyNeural.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImxhbmciIHR5cGU9InN0cmluZyI
Mã ngôn ngữ SSML. Mặc định en-US.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
Azure X-Microsoft-OutputFormat cho âm thanh tiêu chuẩn. Mặc định audio-24khz-48kbitrate-mono-mp3.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlTm90ZU91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
Azure X-Microsoft-OutputFormat cho đầu ra ghi âm thoại. Mặc định ogg-24khz-16bit-mono-opus.
OPENCLAW_DOCS_MARKER:paramClose:
ElevenLabs
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Quay về ELEVENLABS_API_KEY hoặc XI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
ID mô hình (ví dụ eleven_multilingual_v2, eleven_v3).
OPENCLAW_DOCS_MARKER:paramClose:
voiceIdstringvoiceSettingsobjectstability, similarityBoost, style (mỗi giá trị 0..1), useSpeakerBoost (true|false), speed (0.5..2.0, 1.0 = bình thường).
applyTextNormalization"auto" | "on" | "off"OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imxhbmd1YWdlQ29kZSIgdHlwZT0ic3RyaW5nIg
ISO 639-1 gồm 2 chữ cái (ví dụ en, de).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNlZWQiIHR5cGU9Im51bWJlciI
Số nguyên 0..4294967295 để cố gắng đạt tính xác định tốt nhất.
OPENCLAW_DOCS_MARKER:paramClose:
baseUrlstringGoogle Gemini
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Quay về GEMINI_API_KEY / GOOGLE_API_KEY. Nếu bỏ qua, TTS có thể dùng lại models.providers.google.apiKey trước khi quay về env.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
Mô hình TTS Gemini. Mặc định gemini-3.1-flash-tts-preview.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlTmFtZSIgdHlwZT0ic3RyaW5nIg
Tên giọng nói dựng sẵn của Gemini. Mặc định Kore. Bí danh: voice.
OPENCLAW_DOCS_MARKER:paramClose:
audioProfilestringspeakerNamestringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InByb21wdFRlbXBsYXRlIiB0eXBlPSciYXVkaW8tcHJvZmlsZS12MSIn
Đặt thành audio-profile-v1 để bọc các trường prompt persona đang hoạt động trong một cấu trúc prompt TTS Gemini xác định.
OPENCLAW_DOCS_MARKER:paramClose:
personaPromptstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Chỉ chấp nhận https://generativelanguage.googleapis.com.
OPENCLAW_DOCS_MARKER:paramClose:
Gradium
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: GRADIUM_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://api.gradium.ai.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlSWQiIHR5cGU9InN0cmluZyI
Mặc định Emma (YTpq7expH9539ERJ).
OPENCLAW_DOCS_MARKER:paramClose:
Inworld
Inworld chính
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: INWORLD_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://api.inworld.ai.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsSWQiIHR5cGU9InN0cmluZyI
Mặc định inworld-tts-1.5-max. Cũng có: inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlSWQiIHR5cGU9InN0cmluZyI
Mặc định Sarah.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRlbXBlcmF0dXJlIiB0eXBlPSJudW1iZXIi
Nhiệt độ lấy mẫu 0..2.
OPENCLAW_DOCS_MARKER:paramClose:
Local CLI (tts-local-cli)
commandstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFyZ3MiIHR5cGU9InN0cmluZ1tdIg
Đối số lệnh. Hỗ trợ các phần giữ chỗ {{Text}}, {{OutputPath}}, {{OutputDir}}, {{OutputBase}}.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0nIm1wMyIgfCAib3B1cyIgfCAid2F2Iic
Định dạng đầu ra CLI dự kiến. Mặc định mp3 cho tệp đính kèm âm thanh.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg
Thời gian chờ lệnh tính bằng mili giây. Mặc định 120000.
OPENCLAW_DOCS_MARKER:paramClose:
cwdstringenv"Record<string,Microsoft (no API key)
enabledbooleandefault: trueOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
Tên giọng nói neural của Microsoft (ví dụ: en-US-MichelleNeural).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImxhbmciIHR5cGU9InN0cmluZyI
Mã ngôn ngữ (ví dụ: en-US).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
Định dạng đầu ra Microsoft. Mặc định audio-24khz-48kbitrate-mono-mp3. Không phải mọi định dạng đều được hỗ trợ bởi phương thức truyền tải tích hợp dựa trên Edge.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJhdGUgLyBwaXRjaCAvIHZvbHVtZSIgdHlwZT0ic3RyaW5nIg
Chuỗi phần trăm (ví dụ: +10%, -5%).
OPENCLAW_DOCS_MARKER:paramClose:
saveSubtitlesbooleanproxystringtimeoutMsnumberOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImVkZ2UuKiIgdHlwZT0ib2JqZWN0IiBkZXByZWNhdGVk
Bí danh cũ. Chạy openclaw doctor --fix để ghi lại cấu hình đã lưu thành providers.microsoft.
OPENCLAW_DOCS_MARKER:paramClose:
MiniMax
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Dự phòng về MINIMAX_API_KEY. Xác thực Token Plan qua MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, hoặc MINIMAX_CODING_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://api.minimax.io. Env: MINIMAX_API_HOST.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
Mặc định speech-2.8-hd. Env: MINIMAX_TTS_MODEL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlSWQiIHR5cGU9InN0cmluZyI
Mặc định English_expressive_narrator. Env: MINIMAX_TTS_VOICE_ID.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWVkIiB0eXBlPSJudW1iZXIi
0.5..2.0. Mặc định 1.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvbCIgdHlwZT0ibnVtYmVyIg
(0, 10]. Mặc định 1.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InBpdGNoIiB0eXBlPSJudW1iZXIi
Số nguyên -12..12. Mặc định 0. Giá trị thập phân bị cắt bỏ trước yêu cầu.
OPENCLAW_DOCS_MARKER:paramClose:
OpenAI
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Dự phòng về OPENAI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
ID mô hình OpenAI TTS (ví dụ: gpt-4o-mini-tts).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
Tên giọng nói (ví dụ: alloy, cedar).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imluc3RydWN0aW9ucyIgdHlwZT0ic3RyaW5nIg
Trường OpenAI instructions rõ ràng. Khi được đặt, các trường lời nhắc persona không được tự động ánh xạ.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImV4dHJhQm9keSAvIGV4dHJhX2JvZHkiIHR5cGU9IlJlY29yZDxzdHJpbmcsIHVua25vd24
">Các trường JSON bổ sung được hợp nhất vào phần thân yêu cầu /audio/speech sau các trường OpenAI TTS đã tạo. Dùng mục này cho các endpoint tương thích OpenAI như Kokoro cần các khóa riêng theo nhà cung cấp như lang; các khóa prototype không an toàn bị bỏ qua.
OPENCLAW_DOCS_MARKER:paramClose:
baseUrlstringGhi đè endpoint OpenAI TTS. Thứ tự phân giải: cấu hình → OPENAI_TTS_BASE_URL → https://api.openai.com/v1. Các giá trị không mặc định được xem là endpoint TTS tương thích OpenAI, nên tên mô hình và giọng nói tùy chỉnh được chấp nhận.
OpenRouter
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: OPENROUTER_API_KEY. Có thể dùng lại models.providers.openrouter.apiKey.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://openrouter.ai/api/v1. Giá trị cũ https://openrouter.ai/v1 được chuẩn hóa.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
Mặc định hexgrad/kokoro-82m. Bí danh: modelId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
Mặc định af_alloy. Bí danh: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc3BvbnNlRm9ybWF0IiB0eXBlPScibXAzIiB8ICJwY20iJw
Mặc định mp3.
OPENCLAW_DOCS_MARKER:paramClose:
speednumberVolcengine (BytePlus Seed Speech)
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: VOLCENGINE_TTS_API_KEY hoặc BYTEPLUS_SEED_SPEECH_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc291cmNlSWQiIHR5cGU9InN0cmluZyI
Mặc định seed-tts-1.0. Env: VOLCENGINE_TTS_RESOURCE_ID. Dùng seed-tts-2.0 khi dự án của bạn có quyền TTS 2.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwcEtleSIgdHlwZT0ic3RyaW5nIg
Header khóa ứng dụng. Mặc định aGjiRDfUWi. Env: VOLCENGINE_TTS_APP_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Ghi đè endpoint HTTP Seed Speech TTS. Env: VOLCENGINE_TTS_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
Loại giọng nói. Mặc định en_female_anna_mars_bigtts. Env: VOLCENGINE_TTS_VOICE.
OPENCLAW_DOCS_MARKER:paramClose:
speedRationumberemotionstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwcElkIC8gdG9rZW4gLyBjbHVzdGVyIiB0eXBlPSJzdHJpbmciIGRlcHJlY2F0ZWQ
Các trường Volcengine Speech Console cũ. Env: VOLCENGINE_TTS_APPID, VOLCENGINE_TTS_TOKEN, VOLCENGINE_TTS_CLUSTER (mặc định volcano_tts).
OPENCLAW_DOCS_MARKER:paramClose:
xAI
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: XAI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://api.x.ai/v1. Env: XAI_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlSWQiIHR5cGU9InN0cmluZyI
Mặc định eve. Giọng nói trực tiếp: ara, eve, leo, rex, sal, una.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imxhbmd1YWdlIiB0eXBlPSJzdHJpbmci
Mã ngôn ngữ BCP-47 hoặc auto. Mặc định en.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc3BvbnNlRm9ybWF0IiB0eXBlPScibXAzIiB8ICJ3YXYiIHwgInBjbSIgfCAibXVsYXciIHwgImFsYXciJw
Mặc định mp3.
OPENCLAW_DOCS_MARKER:paramClose:
speednumberXiaomi MiMo
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: XIAOMI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
Mặc định https://api.xiaomimimo.com/v1. Env: XIAOMI_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
Mặc định mimo-v2.5-tts. Env: XIAOMI_TTS_MODEL. Cũng hỗ trợ mimo-v2-tts.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlIiB0eXBlPSJzdHJpbmci
Mặc định mimo_default. Env: XIAOMI_TTS_VOICE.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImZvcm1hdCIgdHlwZT0nIm1wMyIgfCAid2F2Iic
Mặc định mp3. Env: XIAOMI_TTS_FORMAT.
OPENCLAW_DOCS_MARKER:paramClose:
stylestringCông cụ agent
Công cụ tts chuyển văn bản thành giọng nói và trả về tệp đính kèm âm thanh để
gửi trả lời. Trên Feishu, Matrix, Telegram và WhatsApp, âm thanh được
gửi dưới dạng tin nhắn thoại thay vì tệp đính kèm. Feishu và
WhatsApp có thể chuyển mã đầu ra TTS không phải Opus trên đường dẫn này khi có
ffmpeg.
WhatsApp gửi âm thanh qua Baileys dưới dạng ghi chú thoại PTT (audio với
ptt: true) và gửi văn bản hiển thị riêng biệt với âm thanh PTT vì
các ứng dụng khách không hiển thị chú thích nhất quán trên ghi chú thoại.
Công cụ chấp nhận các trường tùy chọn channel và timeoutMs; timeoutMs là
thời gian chờ yêu cầu nhà cung cấp theo từng lần gọi, tính bằng mili giây.
Gateway RPC
| Phương thức | Mục đích |
|---|---|
tts.status |
Đọc trạng thái TTS hiện tại và lần thử gần nhất. |
tts.enable |
Đặt tùy chọn tự động cục bộ thành always. |
tts.disable |
Đặt tùy chọn tự động cục bộ thành off. |
tts.convert |
Chuyển một lần văn bản → âm thanh. |
tts.setProvider |
Đặt tùy chọn nhà cung cấp cục bộ. |
tts.setPersona |
Đặt tùy chọn persona cục bộ. |
tts.providers |
Liệt kê các nhà cung cấp đã cấu hình và trạng thái. |
Liên kết dịch vụ
- Hướng dẫn chuyển văn bản thành giọng nói của OpenAI
- Tham chiếu OpenAI Audio API
- Azure Speech REST chuyển văn bản thành giọng nói
- Nhà cung cấp Azure Speech
- ElevenLabs Text to Speech
- Xác thực ElevenLabs
- Gradium
- Inworld TTS API
- MiniMax T2A v2 API
- Volcengine TTS HTTP API
- Tổng hợp giọng nói Xiaomi MiMo
- node-edge-tts
- Định dạng đầu ra Microsoft Speech
- xAI chuyển văn bản thành giọng nói