OpenClaw sử dụng ElevenLabs cho chuyển văn bản thành giọng nói, chuyển giọng nói thành văn bản theo lô với Scribe
v2, và STT truyền trực tuyến với Scribe v2 Realtime.
| Khả năng | Bề mặt OpenClaw | Mặc định |
|---|
| Chuyển văn bản thành giọng nói | messages.tts / talk | eleven_multilingual_v2 |
| Chuyển giọng nói thành văn bản theo lô | tools.media.audio | scribe_v2 |
| Chuyển giọng nói thành văn bản truyền trực tuyến | truyền trực tuyến Voice Call hoặc Google Meet realtime.transcriptionProvider | scribe_v2_realtime |
Xác thực
Đặt ELEVENLABS_API_KEY trong môi trường. XI_API_KEY cũng được chấp nhận để
tương thích với công cụ ElevenLabs hiện có.
export ELEVENLABS_API_KEY="..."
Chuyển văn bản thành giọng nói
{
messages: {
tts: {
providers: {
elevenlabs: {
apiKey: "${ELEVENLABS_API_KEY}",
speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",
modelId: "eleven_multilingual_v2",
},
},
},
},
}
Đặt modelId thành eleven_v3 để sử dụng ElevenLabs v3 TTS. OpenClaw giữ
eleven_multilingual_v2 làm mặc định cho các bản cài đặt hiện có.
Các kênh thoại Discord sử dụng điểm cuối TTS truyền trực tuyến của ElevenLabs khi ElevenLabs là
nhà cung cấp voice.tts/messages.tts được chọn. Việc phát bắt đầu từ luồng âm thanh
được trả về thay vì chờ OpenClaw tải xuống và ghi toàn bộ tệp âm thanh trước. latencyTier ánh xạ tới tham số truy vấn
optimize_streaming_latency của ElevenLabs cho các mô hình chấp nhận tham số đó; OpenClaw
bỏ qua tham số đó cho eleven_v3, vì mô hình này từ chối nó.
Chuyển giọng nói thành văn bản
Sử dụng Scribe v2 cho tệp đính kèm âm thanh đến và các đoạn ghi âm giọng nói ngắn:
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "elevenlabs", model: "scribe_v2" }],
},
},
},
}
OpenClaw gửi âm thanh multipart tới ElevenLabs /v1/speech-to-text với
model_id: "scribe_v2". Gợi ý ngôn ngữ ánh xạ tới language_code khi có.
STT truyền phát
Plugin elevenlabs được đóng gói kèm đăng ký Scribe v2 Realtime cho Voice Call và
bản chép lời truyền phát ở chế độ tác tử của Google Meet.
| Cài đặt | Đường dẫn cấu hình | Mặc định |
|---|
| Khóa API | plugins.entries.voice-call.config.streaming.providers.elevenlabs.apiKey | Dự phòng về ELEVENLABS_API_KEY / XI_API_KEY |
| Mô hình | ...elevenlabs.modelId | scribe_v2_realtime |
| Định dạng âm thanh | ...elevenlabs.audioFormat | ulaw_8000 |
| Tần số lấy mẫu | ...elevenlabs.sampleRate | 8000 |
| Chiến lược commit | ...elevenlabs.commitStrategy | vad |
| Ngôn ngữ | ...elevenlabs.languageCode | (chưa đặt) |
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "elevenlabs",
providers: {
elevenlabs: {
apiKey: "${ELEVENLABS_API_KEY}",
audioFormat: "ulaw_8000",
commitStrategy: "vad",
languageCode: "en",
},
},
},
},
},
},
},
}
Voice Call nhận phương tiện Twilio dưới dạng G.711 u-law 8 kHz. Nhà cung cấp realtime
ElevenLabs mặc định là ulaw_8000, nên các khung thoại điện thoại có thể được chuyển tiếp mà không cần
chuyển mã.
Đối với chế độ tác tử Google Meet, đặt
plugins.entries.google-meet.config.realtime.transcriptionProvider thành
"elevenlabs" và cấu hình cùng khối nhà cung cấp dưới
plugins.entries.google-meet.config.realtime.providers.elevenlabs.
Liên quan