ドキュメント · ガイド

OpenClaw を任意のモデルで

OpenClaw は WhatsApp、Telegram、Discord などで、設定にあるモデルを使って答えます。magpie は OpenClaw に一つのプロバイダとして加わるので、magpie にあるどのモデルでも OpenClaw が動きます：DeepSeek、Kimi、GLM、Qwen、OpenAI キー、ChatGPT や Copilot のサブスクリプション。OpenClaw にキーを貼る必要はありません。

OpenClaw の設定は ~/.openclaw/openclaw.json にあります。magpie はそこに magpie という名前のプロバイダを加えます：ゲートウェイの /v1 アドレス、OpenAI の chat completions API、OpenClaw 専用のキー、そして magpie にある各モデルの項目です。そのうえで選んだモデルを OpenClaw の既定にします。ゲートウェイは各リクエストをそのモデルのプロバイダ向けに変換し、ツール呼び出しと推論もそのままです。

OpenClaw をつなぐ

  1. magpie にプロバイダを追加プロバイダ タブで API キーを追加するか、サブスクリプションにサインインします。
  2. OpenClaw の行でモデルを選ぶエージェント タブの OpenClaw の行でモデルを選びます。OpenClaw は再起動なしで反映します。
ターミナル
magpie openclaw deepseek/deepseek-v4-pro    # OpenClaw を DeepSeek で
magpie openclaw                             # 今のモデルを見る

モデルを選ぶ

OpenClaw ではモデルを プロバイダ/モデル と書くので、magpie のモデルは magpie/deepseek/deepseek-v4-pro、magpie/openai/gpt-6.1 のように出ます。magpie はプライマリのモデルを設定し、fallbacks は残します。許可するモデルの一覧がある場合は、magpie のモデルが拒まれないよう magpie/* を加えます。コンテキスト長が分からないモデルは 128K として伝えます。

すでにモデルを持つチャット

既定のモデルを変えると、新しいチャットにはすぐ反映されます。すでにモデルを持つチャットはそのままです。そのチャットで /model default を送ると新しいモデルに移ります。

magpie が書く内容

書くのは models.providers.magpie、既定のモデル、そして（ある場合は）許可一覧だけです。他のプロバイダ、チャネル、キーはそのままで、magpie のプロバイダに自分で加えたキー（headers、timeoutSeconds、モデルの maxTokens）も残ります。エージェントごとのモデル（agents.entries.*.model）はあなたのもので、$include で分けた設定は変えません。

magpie は OpenClaw と同じ順で設定ファイルを探します：$OPENCLAW_CONFIG_PATH、なければ $OPENCLAW_STATE_DIR の openclaw.json、なければ $OPENCLAW_PROFILE の ~/.openclaw-<profile>、なければ ~/.openclaw。素の JSON ではない JSON5 のファイルは変えず、magpie がそう伝えます。

元に戻す

OpenClaw の行で magpie を外すか、magpie openclaw default を実行します。magpie は自分のプロバイダを消し、既定のモデルがまだ magpie のものなら以前のモデルに戻します。その後に自分で選んだモデルはそのままです。

よくある質問

OpenClaw で ChatGPT サブスクを使えますか？

使えます。magpie で ChatGPT にサインインし、OpenClaw の行で GPT モデルを選びます。OpenClaw のリクエストは magpie に届き、magpie がサブスクを使います。

OpenClaw の再起動は要りますか？

要りません。OpenClaw のゲートウェイはモデルと既定モデルの変更を自分で取り込みます。モデルを持つチャットは、そこで /model default を送るまでそのままです。

チャネルや他のプロバイダは変わりますか？

変わりません。書くのは自分のプロバイダ、既定のモデル、そして（ある場合は）許可一覧だけです。

OpenClaw のプロファイルを使っています。見つけられますか？

見つけられます。OPENCLAW_PROFILE、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH、OPENCLAW_HOME を OpenClaw と同じように読みます。

同じモデルを他のエージェントでも：OpenCode で他のモデル、Hermes Agent を任意のモデルで、Claude Code で他のモデル。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。