Synthetic

Synthetic 提供與 Anthropic 相容的端點。 OpenClaw 將其內建為 synthetic 供應商，並使用 Anthropic Messages API。

屬性	值
供應商	synthetic
驗證	SYNTHETIC_API_KEY
API	Anthropic Messages
基礎 URL	https://api.synthetic.new/anthropic

​

開始使用

1. 取得 API 金鑰

   從你的 Synthetic 帳戶取得 SYNTHETIC_API_KEY，或讓初始設定流程 提示你輸入。

2. 執行初始設定

   openclaw onboard --auth-choice synthetic-api-key
   
3. 驗證預設模型

   初始設定會將預設模型設為：

   synthetic/hf:MiniMaxAI/MiniMax-M3
   

OpenClaw 的 Anthropic 用戶端會自動將 /v1 附加至基礎 URL，因此請使用 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-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 模型的成本（輸入／輸出／快取）皆為 0。如需瞭解服務可用性，請參閱 Synthetic 的 目前模型清單。

模型 ID	上下文視窗	最大權杖數	推理	輸入
hf:MiniMaxAI/MiniMax-M3	262,144	65,536	是	文字 + 圖片
hf:moonshotai/Kimi-K2.7-Code	262,144	8,192	是	文字 + 圖片
hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4	262,144	8,192	是	文字
hf:openai/gpt-oss-120b	131,072	8,192	是	文字
hf:Qwen/Qwen3.6-27B	262,144	81,920	是	文字 + 圖片
hf:zai-org/GLM-4.7-Flash	196,608	131,072	是	文字
hf:zai-org/GLM-5.2	524,288	131,072	是	文字

模型參照採用 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 文件。