> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs

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ó.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export ELEVENLABS_API_KEY="..."
```

## Chuyển văn bản thành giọng nói

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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)                                      |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "elevenlabs",
            providers: {
              elevenlabs: {
                apiKey: "${ELEVENLABS_API_KEY}",
                audioFormat: "ulaw_8000",
                commitStrategy: "vad",
                languageCode: "en",
              },
            },
          },
        },
      },
    },
  },
}
```

<Note>
  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ã.
</Note>

Đố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

* [Chuyển văn bản thành giọng nói](/vi/tools/tts)
* [Google Meet](/vi/plugins/google-meet)
* [Lựa chọn mô hình](/vi/concepts/model-providers)