在 OpenClaw 中配置 Synthetic provider 可以免费接入 MiniMax 和 DeepSeek 等开源模型，使用标准 Anthropic Messages API 协议。关键操作：设置 SYNTHETIC_API_KEY 环境变量，然后运行 openclaw onboard --auth-choice synthetic-api-key。注意 base URL 不要带 /v1 后缀，OpenClaw 客户端会自动添加。

OpenClaw 接入 Synthetic Provider 配置教程

Synthetic 提供兼容 Anthropic 的 API 端点。在 OpenClaw 中它被注册为 synthetic provider，直接使用 Anthropic Messages API 协议。

属性	值
Provider	synthetic
认证	SYNTHETIC_API_KEY
API 协议	Anthropic Messages
Base URL	https://api.synthetic.new/anthropic

怎么配置 Synthetic Provider 接入步骤

获取 API key

从 Synthetic 账户中获取 `SYNTHETIC_API_KEY`，也可以在运行向导时让系统提示输入。

运行 Onboarding 向导

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

确认默认模型

完成配置后，默认模型会被设置为：
```
synthetic/hf:MiniMaxAI/MiniMax-M2.5
```

WARNING

OpenClaw 的 Anthropic 客户端会自动在 base URL 末尾追加 /v1，因此请使用 https://api.synthetic.new/anthropic（不要写成 /anthropic/v1）。如果 Synthetic 更换了 API 端点，请在 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,
          },
        ],
      },
    },
  },
}

支持模型列表（免费，cost=0）

Synthetic 上的所有模型使用 cost: 0（input/output/cache 全部免费），无需支付 token 费用。

模型 ID	上下文窗口	最大 tokens	推理	输入类型
hf:MiniMaxAI/MiniMax-M2.5	192,000	65,536	否	text
hf:moonshotai/Kimi-K2-Thinking	256,000	8,192	是	text
hf:zai-org/GLM-4.7	198,000	128,000	否	text
hf:deepseek-ai/DeepSeek-R1-0528	128,000	8,192	否	text
hf:deepseek-ai/DeepSeek-V3-0324	128,000	8,192	否	text
hf:deepseek-ai/DeepSeek-V3.1	128,000	8,192	否	text
hf:deepseek-ai/DeepSeek-V3.1-Terminus	128,000	8,192	否	text
hf:deepseek-ai/DeepSeek-V3.2	159,000	8,192	否	text
hf:meta-llama/Llama-3.3-70B-Instruct	128,000	8,192	否	text
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8	524,000	8,192	否	text
hf:moonshotai/Kimi-K2-Instruct-0905	256,000	8,192	否	text
hf:moonshotai/Kimi-K2.5	256,000	8,192	是	text + image
hf:openai/gpt-oss-120b	128,000	8,192	否	text
hf:Qwen/Qwen3-235B-A22B-Instruct-2507	256,000	8,192	否	text
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct	256,000	8,192	否	text
hf:Qwen/Qwen3-VL-235B-A22B-Instruct	250,000	8,192	否	text + image
hf:zai-org/GLM-4.5	128,000	128,000	否	text
hf:zai-org/GLM-4.6	198,000	128,000	否	text
hf:zai-org/GLM-5	256,000	128,000	是	text + image
hf:deepseek-ai/DeepSeek-V3	128,000	8,192	否	text
hf:Qwen/Qwen3-235B-A22B-Thinking-2507	256,000	8,192	是	text

TIP

模型引用格式为 synthetic/<modelId>。运行 openclaw models list --provider synthetic 查看你的账户下可用的所有模型。

模型白名单

如果启用了模型白名单（配置在 `agents.defaults.models` 中），需要把所有计划使用的 Synthetic 模型都加入白名单。不在白名单中的模型会从智能体的可选列表中隐藏。

Base URL 覆盖

如果 Synthetic 更换了 API 端点，可以在配置中覆盖 base URL：

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

记住 OpenClaw 客户端会自动在末尾追加 `/v1`。

常见问题

怎么在 OpenClaw 中设置 Synthetic API key？

有两种方式：在 env 或环境变量中直接设置 SYNTHETIC_API_KEY，或者运行 openclaw onboard --auth-choice synthetic-api-key 向导时按提示输入。

Synthetic 支持哪几款免费模型？

Synthetic 内置了 MiniMax M2.5、DeepSeek V3/R1、Kimi 全系、Llama 3.3/4、Qwen3、GLM 等多个模型，全部 cost 为 0，不产生 token 费用。完整列表见上方模型目录表格。

base URL 怎么配置才不会报错？

base URL 固定填写 https://api.synthetic.new/anthropic，不要加入 /v1 后缀，OpenClaw 会自行追加。如果自定义了 base URL，仍然需要确保末尾不加 /v1。