跳转至

Synthetic

Synthetic 提供与 Anthropic 兼容的端点。 OpenClaw 通过官方 @openclaw/synthetic-provider 插件提供该功能，并使用 Anthropic Messages API。

属性 值
提供商 synthetic
认证 SYNTHETIC_API_KEY
API Anthropic Messages
基础 URL https://api.synthetic.new/anthropic

快速开始

1. 安装插件

openclaw plugins install @openclaw/synthetic-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见 应用更改并检查。

2. 获取 API 密钥

从你的 Synthetic 账户获取 SYNTHETIC_API_KEY，或者让引导流程提示你输入一个。

3. 运行引导

openclaw onboard --auth-choice synthetic-api-key

4. 验证默认模型

引导会将默认模型设置为 synthetic/hf:MiniMaxAI/MiniMax-M3。 确认它已注册：

openclaw models list --provider synthetic

Warning

OpenClaw 的 Anthropic 客户端会自动在基础 URL 后追加 /v1，因此请使用 https://api.synthetic.new/anthropic（而不是 /anthropic/v1）。如果 Synthetic 更改其基础 URL，请覆盖 models.providers.synthetic.baseUrl。

配置示例

{
  env: { vars: { SYNTHETIC_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M3": { alias: "MiniMax M3" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "hf:MiniMaxAI/MiniMax-M3",
            name: "MiniMax M3",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

模型发现

使用 Synthetic 凭据时，OpenClaw 会从 Synthetic 的 /openai/v1/models API 发现当前文本模型。 推理仍使用 Anthropic Messages API。新发布的模型，包括 小型模型和 syn: 别名，无需更新 OpenClaw 目录。

实时目录提供上下文和输出限制、图像输入、推理、 工具支持以及基于用量的 token 价格。这些价格是估算值，不是 订阅账单。有关可用性和其推荐别名，请参见 Synthetic 的 当前模型列表。

离线目录生成以及不可用或无法使用的发现响应会使用 内置的种子模型。你选择的模型不会被自动更改。 当你覆盖推理基础 URL 时，OpenClaw 会跳过 Synthetic 的固定 发现 URL，以免将代理凭据发送到 Synthetic。

Tip

模型引用使用 synthetic/<modelId> 形式。使用 openclaw models list --provider synthetic 检查你配置的模型。

模型允许列表

如果你启用了模型允许列表（agents.defaults.modelPolicy.allow），请添加你计划使用的每个 Synthetic 模型。不在允许列表中的模型会对 代理隐藏。

基础 URL 覆盖

如果 Synthetic 更改其 API 端点，请覆盖基础 URL：

{
  models: {
    providers: {
      synthetic: {
        baseUrl: "https://new-api.synthetic.new/anthropic",
      },
    },
  },
}

OpenClaw 仍会自动追加 /v1。

模型提供商

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

配置参考

完整配置架构，包括提供商设置。

Synthetic

Synthetic 仪表板和 API 文档。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw