Providers

Gradium

Gradium یک ارائه‌دهنده تبدیل متن به گفتار برای OpenClaw است. این Plugin می‌تواند پاسخ‌های صوتی عادی (WAV)، خروجی Opus سازگار با یادداشت صوتی، و صدای 8 kHz u-law را برای سطوح تلفنی تولید کند.

ویژگی	مقدار
شناسه ارائه‌دهنده	`gradium`
احراز هویت	`GRADIUM_API_KEY` یا config `apiKey`
URL پایه	`https://api.gradium.ai` (پیش‌فرض)
صدای پیش‌فرض	`Emma` (`YTpq7expH9539ERJ`)

نصب Plugin

Plugin رسمی را نصب کنید، سپس Gateway را بازراه‌اندازی کنید:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

راه‌اندازی

یک کلید API برای Gradium بسازید، سپس آن را با یک env var یا کلید config در اختیار OpenClaw قرار دهید.

Env var

bash

export GRADIUM_API_KEY="gsk_..."

کلید Config

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          apiKey: "${GRADIUM_API_KEY}",        },      },    },  },}

این Plugin ابتدا apiKey حل‌شده را بررسی می‌کند و در صورت نبودن آن، به متغیر محیطی GRADIUM_API_KEY برمی‌گردد.

Config

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}

کلید	نوع	توضیح
`messages.tts.providers.gradium.apiKey`	string	کلید API حل‌شده. از `${ENV}` و ارجاع‌های محرمانه پشتیبانی می‌کند.
`messages.tts.providers.gradium.baseUrl`	string	مبدا API را بازنویسی می‌کند. اسلش‌های انتهایی حذف می‌شوند. مقدار پیش‌فرض `https://api.gradium.ai` است.
`messages.tts.providers.gradium.speakerVoiceId`	string	شناسه صدای پیش‌فرضی که وقتی بازنویسی directive وجود ندارد استفاده می‌شود.

فرمت صدای خروجی به‌صورت خودکار توسط runtime بر اساس سطح هدف انتخاب می‌شود و از openclaw.json قابل پیکربندی نیست. بخش خروجی را در ادامه ببینید.

صداها

نام	شناسه صدا
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

صدای پیش‌فرض: Emma.

بازنویسی صدای هر پیام

وقتی سیاست گفتار فعال اجازه بازنویسی صدا را می‌دهد، می‌توانید با استفاده از یک توکن directive صداها را به‌صورت درون‌خطی عوض کنید. برای شناسه‌های صدای بومی ارائه‌دهنده از speakerVoiceId استفاده کنید.

text

/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

اگر سیاست گفتار بازنویسی صدا را غیرفعال کند، directive مصرف می‌شود اما نادیده گرفته می‌شود.

خروجی

runtime فرمت خروجی را از سطح هدف انتخاب می‌کند. ارائه‌دهنده در حال حاضر فرمت‌های دیگر را تولید نمی‌کند.

هدف	فرمت	پسوند فایل	نرخ نمونه‌برداری	پرچم سازگار با صدا
صدای استاندارد	`wav`	`.wav`	ارائه‌دهنده	خیر
یادداشت صوتی	`opus`	`.opus`	ارائه‌دهنده	بله
تلفنی	`ulaw_8000`	n/a	8 kHz	n/a

ترتیب انتخاب خودکار

در میان ارائه‌دهندگان TTS پیکربندی‌شده، ترتیب انتخاب خودکار Gradium برابر با 30 است. برای اینکه OpenClaw چگونه ارائه‌دهنده فعال را وقتی messages.tts.provider پین نشده است انتخاب می‌کند، تبدیل متن به گفتار را ببینید.

مرتبط

Was this useful?