面向代理的 UnlimitedTTS

面向 AI 代理的非托管式、报价优先文本转语音方案：

• @unlimitedtts/core 校验实时 x402 挑战、执行支出策略、持久化清洗后的收据，并写入私有 MP3 制品。

• @unlimitedtts/mcp 通过 stdio 暴露 tts_list_voices、tts_quote，以及不可逆的 tts_synthesize 工具。

• @unlimitedtts/openclaw 捆绑了 MCP 服务器与 unlimitedtts 代理技能。

• skills/unlimitedtts 支持 MCP 引导式和直接钱包感知型 HTTP 工作流。

已实现的 v1 路径为外部签名模式。单独的 wallet 工具创建 x402 v2 PAYMENT-SIGNATURE；此代码绝不接受助记词或私钥。

安装与构建

需要 Node.js 20 或更高版本以及 pnpm。

pnpm install --frozen-lockfile
pnpm check

从当前代码库运行本地服务器：

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

npm 发布后的通用 MCP 配置：

{
  "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"
      }
    }
  }
}

OpenClaw 本地开发：

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

支付流程

1. tts_list_voices 获取 /docs 和 /tts/voices，并将结果缓存五分钟。

2. tts_quote 在不支付的情况下将确切的合成请求体发送到 /x402/tts，验证返回的 PAYMENT-REQUIRED，执行本地策略，预留滚动预算，并返回一个短期有效的 HMAC 令牌。

3. 钱包仅对返回的 selectedRequirement 进行签名。

4. tts_synthesize 验证令牌、未更改的请求体哈希、完整的 x402 v2 accepted 条目、精确的 EVM 收款方和金额，然后发送一次带支付的重试。

5. 成功调用需要同时满足 audio/mpeg 和 PAYMENT-RESPONSE。它会提交预算，写入清洗后的收据，以模式 0600 原子化存储 MP3，并返回结构化元数据以及 MCP 音频/资源内容。

PAYMENT_OUTCOME_UNKNOWN 会在本地账本中永久隔离该报价。服务器绝不会自动提交或授权第二次支付。

配置

收款方轮换必须通过受信任的配置发布。服务器绝不可能从未受信任的挑战中得知允许的收款方。

生产环境保持默认，并绑定 Base 主网。如需进行 staging 验证，请设置 UNLIMITEDTTS_ENVIRONMENT=staging；这将选择 https://staging-api.unlimitedtts.com、Base Sepolia（eip155:84532）和 staging USDC。当环境未明确为 staging 时，核心会拒绝 staging 来源、网络或资产。

范围

此代码库实现了可移植的本地 MCP、外部钱包适配器合约、代理技能、OpenClaw 包、测试和注册表元数据。托管式 Streamable HTTP、临时 R2 存储、预付卡合成，以及具体的管理式自动签名器，均有意不声明为已完成的 v1 功能。

在启用无人值守的自动签名或托管服务之前，请参阅 所需和推荐的上下游变更。