跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Synthetic 提供 Anthropic 兼容端点。 OpenClaw 将它注册为 synthetic provider，并使用 Anthropic Messages API。
属性值
提供商synthetic
认证SYNTHETIC_API_KEY
APIAnthropic Messages
基础 URLhttps://api.synthetic.new/anthropic

​
入门指南

1

获取 API 密钥

从你的 Synthetic 账户获取一个 SYNTHETIC_API_KEY，或者让新手引导向导提示你输入。
2

运行新手引导

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

验证默认模型

完成新手引导后，默认模型会设置为：
synthetic/hf:MiniMaxAI/MiniMax-M2.5
OpenClaw 的 Anthropic 客户端会自动在基础 URL 后附加 /v1，因此请使用 https://api.synthetic.new/anthropic（而不是 /anthropic/v1）。如果 Synthetic 更改了它的基础 URL，请覆盖 models.providers.synthetic.baseUrl。

​
配置示例

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

​
内置目录

所有 Synthetic 模型的成本都为 0（输入/输出/缓存）。
模型 ID上下文窗口最大 tokens推理输入
hf:MiniMaxAI/MiniMax-M2.5192,00065,536否text
hf:moonshotai/Kimi-K2-Thinking256,0008,192是text
hf:zai-org/GLM-4.7198,000128,000否text
hf:deepseek-ai/DeepSeek-R1-0528128,0008,192否text
hf:deepseek-ai/DeepSeek-V3-0324128,0008,192否text
hf:deepseek-ai/DeepSeek-V3.1128,0008,192否text
hf:deepseek-ai/DeepSeek-V3.1-Terminus128,0008,192否text
hf:deepseek-ai/DeepSeek-V3.2159,0008,192否text
hf:meta-llama/Llama-3.3-70B-Instruct128,0008,192否text
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8524,0008,192否text
hf:moonshotai/Kimi-K2-Instruct-0905256,0008,192否text
hf:moonshotai/Kimi-K2.5256,0008,192是text + image
hf:openai/gpt-oss-120b128,0008,192否text
hf:Qwen/Qwen3-235B-A22B-Instruct-2507256,0008,192否text
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct256,0008,192否text
hf:Qwen/Qwen3-VL-235B-A22B-Instruct250,0008,192否text + image
hf:zai-org/GLM-4.5128,000128,000否text
hf:zai-org/GLM-4.6198,000128,000否text
hf:zai-org/GLM-5256,000128,000是text + image
hf:deepseek-ai/DeepSeek-V3128,0008,192否text
hf:Qwen/Qwen3-235B-A22B-Thinking-2507256,0008,192是text
模型引用使用 synthetic/<modelId> 这种形式。使用 openclaw models list --provider synthetic 可查看你的账户可用的所有模型。
如果你启用了模型允许列表（agents.defaults.models），请添加你计划使用的每个 Synthetic 模型。不在允许列表中的模型将对智能体隐藏。
如果 Synthetic 更改了它的 API 端点，请在配置中覆盖基础 URL：
{
  models: {
    providers: {
      synthetic: {
        baseUrl: "https://new-api.synthetic.new/anthropic",
      },
    },
  },
}
请记住，OpenClaw 会自动附加 /v1。

​
相关内容

模型选择

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

配置参考

包含 provider 设置在内的完整配置 schema。

Synthetic

Synthetic 控制台和 API 文档。