OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Synthetic

Synthetic exposes Anthropic-compatible endpoints. OpenClaw bundles it as the synthetic provider and uses the Anthropic Messages API.

Property Value
Provider synthetic
Auth SYNTHETIC_API_KEY
API Anthropic Messages
Base URL https://api.synthetic.new/anthropic

Getting started

  • Get an API key

    Get a SYNTHETIC_API_KEY from your Synthetic account, or let onboarding prompt you for one.

  • Run onboarding

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

  • Verify the default model

    Onboarding sets the default model to:

    text
    synthetic/hf:MiniMaxAI/MiniMax-M3

    • Config example

    json5
    {  env: { 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,          },        ],      },    },  },}

    Built-in catalog

    All Synthetic models use cost 0 (input/output/cache). See Synthetic's current model list for service availability.

    Model ID Context window Max tokens Reasoning Input
    hf:MiniMaxAI/MiniMax-M3 262,144 65,536 yes text + image
    hf:moonshotai/Kimi-K2.7-Code 262,144 8,192 yes text + image
    hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4 262,144 8,192 yes text
    hf:openai/gpt-oss-120b 131,072 8,192 yes text
    hf:Qwen/Qwen3.6-27B 262,144 81,920 yes text + image
    hf:zai-org/GLM-4.7-Flash 196,608 131,072 yes text
    hf:zai-org/GLM-5.2 524,288 131,072 yes text
    Model allowlist

    If you enable a model allowlist (agents.defaults.modelPolicy.allow), add every Synthetic model you plan to use. Models not in the allowlist are hidden from the agent.

    Base URL override

    If Synthetic changes its API endpoint, override the base URL:

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

    OpenClaw still appends /v1 automatically.

    Model providers

    Provider rules, model refs, and failover behavior.
    Configuration reference

    Full config schema including provider settings.
    Synthetic

    Synthetic dashboard and API docs.
    Was this useful?
    On this page

    On this page