用 Synthetic 輕鬆搞定 OpenClaw 模型對接

以前我為了測試不同的 AI 模型，總是要在各種 API 文件之間跳來跳去，搞得頭很痛。一下要對接這家的格式，一下又要改那家的參數，真的很浪費時間。

後來我發現 Synthetic 這個好東西，它直接把各種模型都包裝成 Anthropic 相容的 API。在 OpenClaw 裡面，你只需要設定一次 synthetic provider，就能直接調用 MiniMax、DeepSeek 或 Qwen 這些模型。這對想省麻煩的開發者來說，真的是目前最推薦的方案。

需要準備的東西

• 已經安裝好的 OpenClaw 環境
• 一組 Synthetic API Key
• 基本的 Terminal 操作經驗
• 對 JSON5 配置有基本概念

快速開始

如果你想在 5 分鐘內搞定，直接照著下面的步驟做：

1. 先設定你的 SYNTHETIC_API_KEY 環境變數（或者等一下跑小幫手時再輸入）。
2. 執行 onboarding 指令：

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

預設會幫你設定好這個模型： synthetic/hf:MiniMaxAI/MiniMax-M2.1

Config 範例

這是你的設定檔參考。我建議直接把這段貼進去改，最不容易出錯：

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

小提醒： OpenClaw 的 Anthropic client 會自動在 baseUrl 後面加上 /v1。所以你在填寫時要用 https://api.synthetic.new/anthropic，不要多寫一個 /v1，不然連線會失敗。

Model Catalog

這裡列出目前支援的模型，這些模型在 Synthetic 上的成本計算目前都是 0。

Model ID	Context window	Max tokens	Reasoning	Input
hf:MiniMaxAI/MiniMax-M2.1	192000	65536	false	text
hf:moonshotai/Kimi-K2-Thinking	256000	8192	true	text
hf:zai-org/GLM-4.7	198000	128000	false	text
hf:deepseek-ai/DeepSeek-V3.1	128000	8192	false	text
hf:meta-llama/Llama-3.3-70B-Instruct	128000	8192	false	text
hf:Qwen/Qwen3-235B-A22B-Thinking-2507	256000	8192	true	text

疑難排解

• API 連不上？ 檢查一下你的 baseUrl。記得不要包含 /v1，因為 OpenClaw 會幫你加。
• 模型找不到？ 如果你開啟了模型的 allowlist (agents.defaults.models)，記得要把你想用的模型 ID 手動加進去，否則 OpenClaw 會過濾掉它。
• 回傳錯誤？ 確認你的 SYNTHETIC_API_KEY 是否正確。你可以嘗試在 Terminal 用 curl 測試看看 API 是否活著。
• 格式跑掉？ 檢查 JSON5 的逗點跟括號。雖然 JSON5 比較寬鬆，但少了括號還是會報錯。

如果你在設定過程中遇到卡關，可以直接找我們的 AI Setup Assistant 幫你 debug。

下一步

• Model providers 規則說明
• 如何自定義 Agent