メインコンテンツへスキップ

Synthetic

Synthetic は Anthropic 互換エンドポイントを提供します。 OpenClaw はこれを synthetic provider として登録し、Anthropic Messages API を使用します。
PropertyValue
Providersynthetic
AuthSYNTHETIC_API_KEY
APIAnthropic Messages
Base URLhttps://api.synthetic.new/anthropic

はじめに

1

Get an API key

Synthetic アカウントから SYNTHETIC_API_KEY を取得するか、 オンボーディングウィザードで入力してください。
2

Run onboarding

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

Verify the default model

オンボーディング後、デフォルトモデルは次のように設定されます:
synthetic/hf:MiniMaxAI/MiniMax-M2.5
OpenClaw の Anthropic client は base URL に自動で /v1 を追加するため、 https://api.synthetic.new/anthropic を使用してください(/anthropic/v1 ではありません)。Synthetic が base 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 モデルは cost 0(input/output/cache)を使用します。
Model IDContext windowMax tokensReasoningInput
hf:MiniMaxAI/MiniMax-M2.5192,00065,536notext
hf:moonshotai/Kimi-K2-Thinking256,0008,192yestext
hf:zai-org/GLM-4.7198,000128,000notext
hf:deepseek-ai/DeepSeek-R1-0528128,0008,192notext
hf:deepseek-ai/DeepSeek-V3-0324128,0008,192notext
hf:deepseek-ai/DeepSeek-V3.1128,0008,192notext
hf:deepseek-ai/DeepSeek-V3.1-Terminus128,0008,192notext
hf:deepseek-ai/DeepSeek-V3.2159,0008,192notext
hf:meta-llama/Llama-3.3-70B-Instruct128,0008,192notext
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8524,0008,192notext
hf:moonshotai/Kimi-K2-Instruct-0905256,0008,192notext
hf:moonshotai/Kimi-K2.5256,0008,192yestext + image
hf:openai/gpt-oss-120b128,0008,192notext
hf:Qwen/Qwen3-235B-A22B-Instruct-2507256,0008,192notext
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct256,0008,192notext
hf:Qwen/Qwen3-VL-235B-A22B-Instruct250,0008,192notext + image
hf:zai-org/GLM-4.5128,000128,000notext
hf:zai-org/GLM-4.6198,000128,000notext
hf:zai-org/GLM-5256,000128,000yestext + image
hf:deepseek-ai/DeepSeek-V3128,0008,192notext
hf:Qwen/Qwen3-235B-A22B-Thinking-2507256,0008,192yestext
model ref は synthetic/<modelId> の形式を使用します。アカウントで利用可能なすべてのモデルを確認するには、 openclaw models list --provider synthetic を使用してください。
model allowlist(agents.defaults.models)を有効にする場合は、 使用予定の Synthetic モデルをすべて追加してください。allowlist にないモデルは agent から見えなくなります。
Synthetic が API エンドポイントを変更した場合は、config で base URL を上書きしてください:
{
  models: {
    providers: {
      synthetic: {
        baseUrl: "https://new-api.synthetic.new/anthropic",
      },
    },
  },
}
OpenClaw が自動で /v1 を追加することを忘れないでください。

関連

Model providers

provider ルール、model ref、フェイルオーバー動作。

Configuration reference

provider 設定を含む完全な config schema。

Synthetic

Synthetic ダッシュボードと API ドキュメント。