QwenPaw (旧 CoPaw) は、AgentScope チームが開発したオープンソースのパーソナル AI アシスタントです。ローカルおよびクラウドでのデプロイをサポートし、Token Plan Team Edition、Coding Plan、または従量課金を介して Alibaba Cloud Model Studio と統合します。
QwenPaw のインストール
pip パッケージまたはワンクリックインストールスクリプトを使用してください。Docker、デスクトップアプリ、または ModelScope オンラインランタイムについては、「QwenPaw 公式ドキュメント」をご参照ください。
pip install
Python 3.10 ~ 3.13 が必要です：
pip install qwenpaw
qwenpaw init --defaults
qwenpaw appワンクリックインストールスクリプト
このスクリプトは、uv のインストール、仮想環境の作成、依存関係のダウンロードを自動的に行います。手動での Python セットアップは不要です。お使いのオペレーティングシステムに応じたコマンドを選択してください：
-
macOS / Linux：
curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash -
Windows (CMD)：
curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat -
Windows (PowerShell)：
irm https://qwenpaw.agentscope.io/install.ps1 | iex
インストール後、新しいターミナルで以下を実行してください：
qwenpaw init --defaults
qwenpaw app起動後、http://127.0.0.1:8088/ にアクセスして QwenPaw コンソールを開きます。
認証情報の設定
Console で、[Settings] > [Models] の順にクリックして、お使いの料金プランに対応するプロバイダーを設定してください。
Token Plan Team Edition
QwenPaw には、Token Plan Team Edition 用の組み込みプロバイダーは含まれていません。[プロバイダー] ページで、[プロバイダーの追加] をクリックします。[プロトコル] を [OpenAI 互換 (チャット補完)] に設定します (プロバイダー ID と名前はカスタマイズ可能です。例: bailian-token-plan)。保存後、[設定] ページを開き、以下の表に記入します。
|
設定 |
説明 |
|
ベース URL |
|
|
API キー |
Token Plan Team Edition 専用のAPI キーを入力してください。 |
|
モデル |
プロバイダーの [Models] ページで [Add Model] をクリックし、[Model ID] をサポートされている Token Plan Team Edition のモデルに設定してください。 |
Coding Plan
組み込みの [Aliyun Coding Plan (International)] プロバイダーの [Settings] ページを開き、API キーを入力してください。
|
設定 |
説明 |
|
API キー |
Coding Plan 専用のAPI キーを入力してください。 |
|
モデル |
一般的なモデルは事前設定されています。[Models] ページの [Test Connection] で確認してください。モデルを追加するには、[Add Model] をクリックし、[Model ID] をサポートされている Coding Plan のモデルに設定してください。 |
従量課金
[DashScope] プロバイダーの [Settings] ページを開き、API キーを入力してください。ベース URL はデフォルトで中国 (北京) に設定されています。ドロップダウンメニューからリージョンを切り替えることができます。
|
設定 |
説明 |
|
API キー |
選択したリージョンに対応するAlibaba Cloud Model Studio の API キーを入力してください。 |
|
ベース URL |
ドロップダウンから、モデルのデプロイリージョンに一致する URL を選択してください：
|
|
モデル |
一般的なモデルは事前設定されています。モデルを追加するには、[Add Model] をクリックし、[Model ID] をサポートされているモデルに設定してください。 |
デフォルトモデルの設定
[Settings] > [Models] > [Default LLM] を開き、モデルを選択して [Save] をクリックしてください。チャットページ右上のドロップダウンで、現在のセッションのプロバイダーとモデルを切り替えることができます。
よくある質問
エラーコード
料金プラン別のトラブルシューティング：
-
従量課金： エラーコードのトラブルシューティング
-
Coding Plan： Coding Plan FAQ
-
Token Plan Team Edition： Token Plan Team Edition FAQ
エラー 401: API キーが正しくありません
考えられる原因：
-
3 つの料金プラン間で API キーの互換性はありません。API キーとベース URL が同じプランのものであることを確認してください。
-
従量課金の API キーとベース URL のリージョンが一致していません。
長い会話やツール呼び出しにおけるコンテキスト長の超過
そのモデルのプロバイダーの [設定] ページで [詳細設定] を展開し、max_tokens などの生成パラメーターを JSON 形式で調整して、保存します:
{
"temperature": 0.7,
"top_p": 0.9,
"max_tokens": 4096
}