OpenClaw

OpenClaw は、お使いのマシン上で動作するセルフホスト型のパーソナル AI で、すでに利用しているチャネル（WhatsApp、Telegram、Slack、Discord、iMessage など多数）を通じて応答します。複数のモデルプロバイダーをサポートしており、Synthorai をその 1 つとして追加すれば、ワークスペース内の任意の 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 プロトコルを対象とする 2 つ目の 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`	Alibaba 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.

「Unknown model」 — モデル slug は次の場所の id 列と一致する必要があります /console/pricing. 次の方法で参照する場合は agent.model = "synthorai/MODEL_ID" 次を確認してください MODEL_ID が、指定した key でルーティング可能であることを確認してください。

プライベート / エアギャップ環境へのデプロイ — 同じ JSON 形式が機能します。公開されている次の項目を置き換えるだけです https://synthorai.io を内部ゲートウェイのホスト名に置き換えてください。

常時稼働のアシスタントで各選択肢がいくらかかるかを知るには、想定利用量を LLM API cost calculator に通してみてください。