UnlimitedTTS

面向 Agent 的 UnlimitedTTS

面向 AI Agent 的非托管、先报价文本转语音：

• @unlimitedtts/core 验证实时 x402 挑战，执行支出策略，持久化经过清理的收据，并写入私有 MP3 文件。
• @unlimitedtts/mcp 通过 stdio 提供 tts_list_voices、tts_quote 和不可逆的 tts_synthesize 工具。
• @unlimitedtts/openclaw 捆绑 MCP 服务和 unlimitedtts Agent 技能。
• skills/unlimitedtts 支持 MCP 引导式工作流和可直接使用钱包的 HTTP 工作流。

已实现的 v1 路径为外部签名模式。独立的钱包工具会创建 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/[email protected]"],
      "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

支付流程

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 会在本地账本中永久隔离该报价。服务绝不会自动提交或授权第二笔付款。

配置

环境变量	默认值
UNLIMITEDTTS_ENVIRONMENT	production；如需使用 staging API 和 Base Sepolia，请显式设置为 staging
UNLIMITEDTTS_API_ORIGIN	https://api.unlimitedtts.com
UNLIMITEDTTS_ALLOWED_NETWORKS	eip155:8453
UNLIMITEDTTS_ALLOWED_ASSETS	Base USDC 合约
UNLIMITEDTTS_ALLOWED_PAYEES	从经验证的 2026 年 7 月 30 日发布合约中固定的收款方
UNLIMITEDTTS_MAX_USDC_PER_CALL	0.10
UNLIMITEDTTS_ROLLING_24H_USDC	1.00
UNLIMITEDTTS_APPROVAL_THRESHOLD_USDC	0.05
UNLIMITEDTTS_REQUIRE_APPROVAL	first-payment-and-over-threshold
UNLIMITEDTTS_OUTPUT_DIRECTORY	服务工作目录下的 .unlimitedtts-artifacts
UNLIMITEDTTS_QUOTE_TOKEN_SECRET	每个进程随机生成；多实例部署时请配置密钥

收款方轮换必须通过可信配置发布。服务绝不会从不可信的挑战中获取允许的收款方。

生产环境仍为默认环境，并固定使用 Base 主网。要进行 staging 验证，请设置 UNLIMITEDTTS_ENVIRONMENT=staging；这会选择 https://staging-api.unlimitedtts.com、Base Sepolia（eip155:84532）和 staging USDC。如果未显式设置环境为 staging，核心模块会拒绝 staging 来源、网络或资产。

范围

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

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