Providers
Deepgram
Deepgram là một API chuyển giọng nói thành văn bản. OpenClaw sử dụng API này để phiên âm âm thanh/ghi chú thoại đầu vào thông qua tools.media.audio và để phát trực tuyến STT cho Cuộc gọi thoại thông qua plugins.entries.voice-call.config.streaming.
Tính năng phiên âm hàng loạt tải toàn bộ tệp âm thanh lên Deepgram và chèn bản phiên âm vào quy trình phản hồi (khối {{Transcript}} + [Audio]). Tính năng phát trực tuyến Cuộc gọi thoại chuyển tiếp các khung G.711 u-law trực tiếp qua điểm cuối WebSocket listen của Deepgram và phát ra các bản phiên âm từng phần/hoàn chỉnh khi Deepgram trả về.
| Chi tiết | Giá trị |
|---|---|
| Trang web | deepgram.com |
| Tài liệu | developers.deepgram.com |
| Xác thực | DEEPGRAM_API_KEY |
| Mô hình mặc định | nova-3 |
Bắt đầu
Đặt khóa API
DEEPGRAM_API_KEY=dg_...Bật nhà cung cấp âm thanh
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Gửi ghi chú thoại
Gửi tin nhắn âm thanh qua bất kỳ kênh nào đã kết nối. OpenClaw phiên âm tin nhắn đó qua Deepgram và chèn bản phiên âm vào quy trình phản hồi.
Các tùy chọn cấu hình
| Tùy chọn | Đường dẫn | Mô tả |
|---|---|---|
model |
tools.media.audio.models[].model |
ID mô hình Deepgram (mặc định: nova-3) |
language |
tools.media.audio.models[].language |
Gợi ý ngôn ngữ (không bắt buộc) |
providerOptions.deepgram hợp nhất các tham số truy vấn bổ sung trực tiếp vào yêu cầu
/listen của Deepgram, vì vậy mọi tên tham số được Deepgram hỗ trợ đều hoạt động
(ví dụ: detect_language, punctuate, smart_format):
Có gợi ý ngôn ngữ
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Có các tùy chọn Deepgram
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}STT phát trực tuyến cho Cuộc gọi thoại
Plugin deepgram đi kèm cũng đăng ký một nhà cung cấp phiên âm theo thời gian thực
cho Plugin Cuộc gọi thoại.
| Cài đặt | Đường dẫn cấu hình | Mặc định |
|---|---|---|
| Khóa API | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
Dùng DEEPGRAM_API_KEY nếu không đặt |
| Mô hình | ...deepgram.model |
nova-3 |
| Ngôn ngữ | ...deepgram.language |
(chưa đặt) |
| Mã hóa | ...deepgram.encoding |
mulaw |
| Tần số lấy mẫu | ...deepgram.sampleRate |
8000 |
| Phân định điểm cuối | ...deepgram.endpointingMs |
800 |
| Kết quả tạm thời | ...deepgram.interimResults |
true |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "deepgram", providers: { deepgram: { apiKey: "${DEEPGRAM_API_KEY}", model: "nova-3", endpointingMs: 800, language: "en-US", }, }, }, }, }, }, },}Ghi chú
Xác thực
Quá trình xác thực tuân theo thứ tự xác thực nhà cung cấp tiêu chuẩn. DEEPGRAM_API_KEY là
cách đơn giản nhất.
Proxy và điểm cuối tùy chỉnh
Ghi đè điểm cuối hoặc tiêu đề bằng tools.media.audio.baseUrl và
tools.media.audio.headers khi sử dụng proxy.
Hành vi đầu ra
Đầu ra tuân theo cùng các quy tắc âm thanh như những nhà cung cấp khác (giới hạn kích thước, thời gian chờ, chèn bản phiên âm).
