Telnyx

Telnyx AI 推理 提供托管的、OpenAI 兼容的开放权重模型访问，以及代理的前沿模型路由。由供应商维护的外部 @telnyx/openclaw-provider 插件提供运行时；OpenClaw 承载其目录和入门引导元数据。经过身份验证的发现会遵循您的 Telnyx 账户已启用的完整模型集，而离线回退包含构建该插件版本时可用的模型。

要求¶

@telnyx/openclaw-provider@0.2.0 的目录固定版本要求 OpenClaw 2026.8.1 或更高版本。安装插件前请升级 OpenClaw：

openclaw update
openclaw --version

安装插件¶

openclaw plugins install telnyx
openclaw gateway restart

入门引导¶

1. 创建 Telnyx 账户和 API 密钥

在 Telnyx API 密钥门户 中创建密钥。推理调用按用量计费；有关当前模型和费率，请参阅 Telnyx 推理文档。

2. 运行入门引导

openclaw onboard --auth-choice telnyx-api-key

openclaw onboard --non-interactive --accept-risk \
  --auth-choice telnyx-api-key \
  --telnyx-api-key "$TELNYX_API_KEY"

export TELNYX_API_KEY=...

3. 验证实时目录

openclaw models list --refresh --provider telnyx

在可用认证下，插件会请求经过身份验证的 /models 端点，并列出为该账户返回的所有模型。如果没有认证，它会保持离线状态并使用内置回退。

默认模型¶

telnyx/moonshotai/Kimi-K3 是默认模型。在 OpenClaw 中，它支持文本和图像输入、工具调用、推理、1M token 上下文窗口，以及最多 64k 输出 token：

{
  agents: {
    defaults: {
      model: { primary: "telnyx/moonshotai/Kimi-K3" },
    },
  },
}

使用 /model telnyx/moonshotai/Kimi-K3 切换现有聊天。

实时模型发现¶

插件会获取经过身份验证的 /models 端点，并将结果缓存五分钟，然后将这些行合并到内置目录之上。新发布的 Telnyx 模型会自动出现，无需等待插件版本发布，包括代理的前沿模型路由，例如 telnyx/openai/gpt-5.x、telnyx/anthropic/claude-haiku-4-5 和 telnyx/google/gemini-2.5-flash。

内置回退目录¶

经过身份验证的实时目录是权威来源。这些行可确保在发现成功之前，设置和模型选择仍然可用：

所有内置模型都支持工具调用和推理。openai/* 和 anthropic/* ID 是 Telnyx 代理的前沿模型路由；其余为 Telnyx 托管的开放权重模型。流式用量在最后一个数据块中报告。

手动配置¶

大多数设置只需要 API 密钥。若要显式固定提供商：

{
  env: { vars: { TELNYX_API_KEY: "..." } },
  agents: {
    defaults: {
      model: { primary: "telnyx/moonshotai/Kimi-K3" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      telnyx: {
        baseUrl: "https://api.telnyx.com/v2/ai/openai",
        apiKey: "${TELNYX_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "moonshotai/Kimi-K3",
            name: "Kimi K3",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}

相关¶

模型提供商

选择提供商、模型引用和故障转移行为。

思考模式

选择 OpenClaw 推理强度级别。

模型 CLI

列出、查看并选择已发现的模型。

模型常见问题

身份验证配置文件和模型选择故障排除。