UnlimitedTTS for Agents

Nicht-verwahrendes, zuerst Angebot einholendes Text-to-Speech für KI-Agenten:

• @unlimitedtts/core validiert Live-x402-Challenges, setzt die Ausgabenrichtlinie durch, speichert bereinigte Belege und schreibt private MP3-Artefakte.

• @unlimitedtts/mcp stellt die Tools tts_list_voices, tts_quote und das irreversible tts_synthesize über stdio bereit.

• @unlimitedtts/openclaw bündelt den MCP-Server und die Agent-Skill unlimitedtts.

• skills/unlimitedtts unterstützt MCP-geführte und direkte wallet-bewusste HTTP-Workflows.

Der implementierte v1-Pfad ist der Modus mit externer Signatur. Ein separates Wallet-Tool erstellt die x402-v2-PAYMENT-SIGNATURE; dieser Code akzeptiert niemals eine Seed-Phrase oder einen privaten Schlüssel.

Installation und Build

Node.js 20 oder neuer und pnpm sind erforderlich.

pnpm install --frozen-lockfile
pnpm check

Führen Sie den lokalen Server aus diesem Checkout aus:

pnpm --filter @unlimitedtts/mcp build
node packages/mcp/dist/cli.js

Generische MCP-Konfiguration nach der npm-Veröffentlichung:

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/mcp@0.1.0"],
      "env": {
        "UNLIMITEDTTS_MAX_USDC_PER_CALL": "0.10",
        "UNLIMITEDTTS_ROLLING_24H_USDC": "1.00",
        "UNLIMITEDTTS_OUTPUT_DIRECTORY": "/absolute/approved/output"
      }
    }
  }
}

Lokale OpenClaw-Entwicklung:

pnpm --filter @unlimitedtts/openclaw build
openclaw plugins install -l ./packages/openclaw
openclaw plugins enable unlimitedtts
openclaw gateway restart
openclaw plugins inspect unlimitedtts --runtime --json
openclaw plugins doctor

Related MCP server: mcp-ai-voice

Zahlungsablauf

1. tts_list_voices ruft /docs und /tts/voices ab und speichert das Ergebnis fünf Minuten lang zwischen.

2. tts_quote sendet den exakten Synthese-Body ohne Zahlung an /x402/tts, validiert das zurückgegebene PAYMENT-REQUIRED, setzt die lokale Richtlinie durch, reserviert ein rollierendes Budget und gibt ein kurzlebiges HMAC-Token zurück.

3. Ein Wallet signiert nur das zurückgegebene selectedRequirement.

4. tts_synthesize verifiziert das Token, den unveränderten Body-Hash, den vollständigen x402-v2-accepted-Eintrag, den exakten EVM-Zahlungsempfänger und -Betrag und sendet dann einen bezahlten Wiederholungsversuch.

5. Ein erfolgreicher Aufruf erfordert sowohl audio/mpeg als auch PAYMENT-RESPONSE. Er bestätigt das Budget, schreibt einen bereinigten Beleg, speichert die MP3 atomar mit Modus 0600 und gibt strukturierte Metadaten sowie MCP-Audio-/Ressourceninhalte zurück.

PAYMENT_OUTCOME_UNKNOWN stellt dieses Angebot dauerhaft im lokalen Ledger unter Quarantäne. Der Server übermittelt oder autorisiert niemals automatisch eine zweite Zahlung.

Konfiguration

Die Rotation des Zahlungsempfängers muss über vertrauenswürdige Konfiguration freigegeben werden. Der Server erfährt niemals einen zulässigen Zahlungsempfänger aus einer nicht vertrauenswürdigen Challenge.

Production bleibt die Standardeinstellung und ist an Base Mainnet gebunden. Für die Staging-Validierung setzen Sie UNLIMITEDTTS_ENVIRONMENT=staging; dies wählt https://staging-api.unlimitedtts.com, Base Sepolia (eip155:84532) und Staging-USDC. Der Kern lehnt den Staging-Ursprung, das Netzwerk oder das Asset ab, wenn die Umgebung nicht explizit staging ist.

Umfang

Dieses Checkout implementiert das portable lokale MCP, den externen Wallet-Adapter-Vertrag, die Agent-Skill, das OpenClaw-Paket, Tests und Registry-Metadaten. Gehostetes Streamable HTTP, temporärer R2-Speicher, Prepaid-Karten-Synthese und ein konkreter verwalteter automatischer Signierer werden bewusst nicht als abgeschlossene v1-Funktionen beworben.

Siehe erforderliche und empfohlene Upstream-Änderungen, bevor Sie unbeaufsichtigtes automatisches Signieren oder einen gehosteten Dienst aktivieren.