OpenClaw

OpenClaw 是一個自架的個人 AI，執行在你的機器上，並透過你已經在使用的管道（WhatsApp、Telegram、Slack、Discord、iMessage 等眾多管道）進行回應。它支援多個模型提供方——將 Synthorai 新增為其中之一後，你工作空間中的任意 chat 模型即可透過 OpenClaw 的 agent 設定存取。

開始之前

你需要：(1) 一個在本機執行的 OpenClaw 安裝；(2) 一個來自以下位置的 Synthorai API key Console → API Keys.

第 1 步 — 編輯 ~/.openclaw/openclaw.json

在以下位置新增 Synthorai providers. 現有的 openai/anthropic 項目可以保留——OpenClaw 會使用被以下項引用的那一個 agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai 告訴 OpenClaw 使用 OpenAI Chat Completions 協定。Synthorai 在以下端點上完全相容 OpenAI /v1/chat/completions，因此它適用於你工作空間中的任意 chat 模型——不僅限於 OpenAI 託管的模型。

第 2 步 —（選用）再新增一個 Claude 原生 provider

如果你特別想使用 Anthropic 的原生 message 格式（僅限 Claude 系列模型），請新增第二個面向 Anthropic 協定的 provider。請注意 base_url 不包含 /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

第 3 步 — 重新啟動 OpenClaw

OpenClaw 會重新讀取 openclaw.json 於啟動時。重新啟動後，從 OpenClaw 綁定的任意管道（如 Slack、Telegram）傳送你的第一則訊息——agent 將使用你設定的 Synthorai 模型進行回應。

參數	類型	說明
`gpt-5.4-mini`	`fast`	OpenAI；快速且低成本。良好的預設選擇。
`qwen3.5-flash`	`fast`	阿里 Qwen；在中文 + 程式碼 + 多語言場景下價格有競爭力。
`claude-sonnet-4-6`	`balanced`	Anthropic；最適合更長上下文的對話。需要上述 claude provider 形態。
`gemini-2.5-flash`	`fast`	Google；上下文視窗長，適合大量檔案的工作流。

疑難排解

OpenClaw 各版本之間的欄位名不一致 — 上面所示的欄位 (type / base_url / api_key) 是常見的寫法。如果某個特定的 OpenClaw 版本將它們重新命名 (e.g. provider_type / baseUrl)，請查閱官方設定參考，並替換為相同的值。

401 / 403 — API key 錯誤、已停用或配額不足。請檢查 /console/keys 和 /console/billing.

「未知模型」 — 模型 slug 必須與以下位置的 id 欄位匹配 /console/pricing. 如果你透過以下方式引用它 agent.model = "synthorai/MODEL_ID" 請確保 MODEL_ID 可由你提供的 key 路由。

私有 / 隔離網路部署 — 相同的 JSON 格式同樣適用；只需替換公開的 https://synthorai.io 為你的內部閘道主機名稱。

想知道常駐助手情境下每個選項的花費?把你的預期用量放進 LLM API cost calculator 算一算。