ドキュメント · ガイド

QwenPaw を任意のモデルで

QwenPaw（agentscope-ai/QwenPaw、旧名 CoPaw）は独自のエージェントを持つ個人向けアシスタントアプリです。magpie は QwenPaw に OpenAI 互換の magpie プロバイダーを加えて magpie のすべてのモデルを並べ、選んだモデルをエージェントの active_model にします。そのため QwenPaw のエージェントで magpie のすべてのモデル（DeepSeek、GLM、Kimi、Qwen、OpenAI や Anthropic のキー、ChatGPT や Copilot のサブスクリプション）が使え、エージェントごとに別のモデルにもできます。

QwenPaw の設定

  1. QwenPaw を一度起動するqwenpaw app を実行して、エージェントの設定（agent.json）を書かせます。
  2. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  3. QwenPaw の行でモデルを選ぶエージェント ページで QwenPaw に magpie のモデルを選び、必要なら思考の強さも選びます。
  4. 最初の接続のあと QwenPaw を再起動QwenPaw はプロバイダーのファイルを起動時にだけ読みます。一度再起動すれば使えます。
ターミナル
magpie qwenpaw deepseek/deepseek-v4-pro          # 既定のエージェント
magpie qwenpaw#writer deepseek/deepseek-v4-flash  # writer という名前のエージェント
magpie qwenpaw effort high                        # thinking_level

書かれるファイル

QwenPaw の作業フォルダーは QWENPAW_WORKING_DIR、なければ旧来の ~/.copaw があればそれ、なければ ~/.qwenpaw です。シークレットフォルダーは QWENPAW_SECRET_DIR（作業フォルダーの .env でも設定できます）、なければ <作業フォルダー>.secret（例 ~/.qwenpaw.secret）です。

magpie は <シークレットフォルダー>/providers/custom/magpie.json を、QwenPaw のコンソールの「プロバイダーを追加」が保存するのと同じ形で書きます：OpenAI Chat Completions（OpenAIChatModel）、ゲートウェイの /v1、QwenPaw と分かるキー、extra_models に magpie の各モデル。そしてエージェントの agent.json の active_model を provider magpie と選んだモデルにします。思考の強さは thinking_level（minimal、low、medium、high、xhigh、max、空ならモデル自身の inherit）です。

ターミナル
// ~/.qwenpaw.secret/providers/custom/magpie.json
{"id": "magpie", "name": "magpie", "base_url": "http://127.0.0.1:3425/v1",
 "api_key": "…", "chat_model": "OpenAIChatModel", "is_custom": true,
 "extra_models": [{"id": "deepseek/deepseek-v4-pro", …}, …]}

// ~/.qwenpaw/workspaces/default/agent.json
{"active_model": {"provider_id": "magpie", "model": "deepseek/deepseek-v4-pro"},
 "thinking_level": "high", …}

QwenPaw はキーを暗号化して保存します（ENC: で始まる）。magpie は平文で書き、QwenPaw が次の起動時に暗号化します。これは QwenPaw 自身のファイルがキーを持つ方法と同じなので、キーは QwenPaw が保存しない場所には出ません。プロバイダーのファイルは本人だけが読めます（0600）。

反映されるタイミング

QwenPaw はプロバイダーのファイルを起動時に一度だけ読むので、最初の接続のあとと magpie のモデルが変わったあとに一度再起動してください。それまでは magpie のモデルでの会話が Provider 'magpie' not found で失敗します。その後エージェントのモデルを変えるのに再起動は要りません。QwenPaw は agent.json の変更を読み直し、毎ターンモデルを取るので、次のメッセージから新しいモデルが使われます。

複数のエージェント

QwenPaw の各エージェントは magpie で一行です。qwenpaw は常にある default エージェント、ほかは qwenpaw#<id> です。そのモデルを使うのは QwenPaw 自身のバックエンド（既定の qwenpaw）のエージェントだけです。ACP バックエンドのエージェントは別のプログラムを動かすので、magpie はつながず、先に QwenPaw 自身のバックエンドに切り替えるよう知らせます。

自分の設定

エージェントの以前の active_model は記録され、magpie を外すと戻ります。fallback_models と subagent_model はそのままです。QwenPaw のコンソールで magpie のプロバイダーに加えた変更（モデルのウィンドウ、生成設定、プロバイダーのヘッダー）も残ります。QwenPaw で magpie のプロバイダーをオフにしたり消したりすると、magpie のチェックがもう magpie を通らないと知らせます。

元に戻す

magpie で行を既定に戻すと、エージェントの active_model を戻します。custom/magpie.json を消すのは、fallback や subagent のモデルも含めてどのエージェントも magpie のプロバイダーを使わなくなってからです。自分のプロバイダーのモデルを選ぶこともでき、magpie のプロバイダーは切断するまでリストに残ります。

ターミナル
magpie qwenpaw default

よくある質問

QwenPaw で DeepSeek、GLM、Kimi、Qwen は使えますか？

使えます。magpie が QwenPaw のシークレットフォルダーに OpenAI 互換の magpie プロバイダーを書き、選んだモデルをエージェントの active_model にします。最初の接続のあと QwenPaw を一度再起動してください。

Provider 'magpie' not found と出ます。

QwenPaw はプロバイダーのファイルを起動時にだけ読みます。接続後に一度再起動してください。その後のモデル変更は次のメッセージから反映され、再起動は要りません。

CoPaw でも使えますか？

使えます。QwenPaw の旧名が CoPaw で、旧来の ~/.copaw があれば magpie も QwenPaw と同じくそれを作業フォルダーにします。

エージェントごとに別のモデルにできますか？

できます。default エージェントは magpie の qwenpaw の行、ほかは qwenpaw# で、それぞれモデルと思考の強さを選べます。

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