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à để truyền trực tiếp STT cho Cuộc gọi thoại thông qua plugins.entries.voice-call.config.streaming.
Phiên âm hàng loạt tải toàn bộ tệp âm thanh lên Deepgram và đưa bản phiên âm vào quy trình phản hồi (khối {{Transcript}} + [Audio]).
Tính năng truyền trực tiếp Cuộc gọi thoại chuyển tiếp các khung G.711 u-law theo thời gian thực 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 một tin nhắn âm thanh qua bất kỳ kênh nào đã kết nối. OpenClaw phiên âm qua Deepgram và đưa bản phiên âm vào quy trình phản hồi.
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 trực tiếp các tham số truy vấn bổ sung vào yêu cầu
Deepgram /listen, vì vậy có thể sử dụng mọi tên tham số được Deepgram hỗ trợ
(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ó 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 truyền trực tiếp 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 làm phương án dự phòng |
| URL cơ sở | ...deepgram.baseUrl |
DEEPGRAM_BASE_URL hoặc API công khai của Deepgram |
| 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 đoạn đ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", }, }, }, }, }, }, },}Đối với điểm cuối tùy chỉnh của Deepgram,
hãy đặt baseUrl thành gốc điểm cuối, bao gồm mọi đường dẫn cơ sở nhưng không bao gồm /listen.
Các điểm cuối theo thời gian thực chấp nhận http://, https://, ws:// và wss://. HTTP
được ánh xạ sang WS, HTTPS được ánh xạ sang WSS, còn các lược đồ WebSocket được chỉ định rõ ràng sẽ không thay đổi.
URL không hợp lệ và các lược đồ khác sẽ gây lỗi trong quá trình thiết lập phiên.
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 đè các đ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ác quy tắc âm thanh giống như các nhà cung cấp khác (giới hạn kích thước, thời gian chờ, đưa bản phiên âm vào quy trình).
