OpenClawで通義千問（Qwen）モデルを統合する

通義千問（Qwen）モデルの概要

通義千問はAlibaba Cloudが開発した大規模言語モデルシリーズで、特に中国語の理解と生成に優れています。Qwenシリーズは軽量級から超大規模モデルまで幅広く展開しており、日常会話から複雑な推論まで様々なシナリオに対応します。中国語話者をターゲットとするアプリケーションにとって、Qwenは非常に競争力のある選択肢です。

OpenClawはQwenをネイティブサポートプロバイダーとして含んでおり、統一フォーマットqwen/モデル名で任意のQwenモデルバリエーションを直接呼び出すことができます。

APIキーの取得

通義千問のAPIサービスを使用するには、Alibaba Cloudプラットフォームで以下の手順を完了する必要があります。

Alibaba Cloudアカウントを登録してログインする。
Alibaba Cloudコンソールで「モデルサービスリンジー（DashScope）」を検索して有効化する。
DashScopeコンソールのAPIキー管理ページで新しいAPIキーを作成する。
APIキーを記録する（設定時に必要）。

Alibaba Cloudは通常、新規ユーザーに一定量の無料API呼び出しを提供しており、本番使用前にテストすることができます。

クイック設定

OpenClawの対話型オンボーディングツールでクイックセットアップします。

openclaw onboard

オンボーディングフローでQwenをプロバイダーとして選択し、DashScope APIキーを入力してデフォルトモデルを選択します。

手動設定ファイルの編集

openclaw.jsonでQwenモデルを手動設定します。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen/qwen-max"
      }
    }
  }
}

認証設定

{
  "providers": {
    "qwen": {
      "auth": [
        {
          "key": "your-dashscope-api-key"
        }
      ]
    }
  }
}

他のOpenClawプロバイダーと同様に、アカウントローテーションとフェイルオーバーのために複数のAPIキーを設定できます。

{
  "providers": {
    "qwen": {
      "auth": [
        { "key": "key-A", "profile": "primary" },
        { "key": "key-B", "profile": "backup" }
      ]
    }
  }
}

プライマリキーがレート制限に達すると、OpenClawは自動的にバックアップキーに切り替え、プライマリキーにクールダウン追跡を適用し、クールダウン期間終了後にローテーションプールに再追加します。

Qwenモデルの推奨

通義千問は複数のティアのモデルバリエーションを提供しています。

qwen/qwen-max：フラッグシップモデルで最も強力な総合性能。複雑な推論、コンテンツ作成、専門Q&Aに適している。
qwen/qwen-plus：バランス型で、性能とコストの良いトレードオフ。ほとんどの日常シナリオに適している。
qwen/qwen-turbo：高速応答バリエーションで、最低レイテンシと最高のコスト効率。簡単な会話や高並行シナリオに適している。
qwen/qwen-long：長文コンテキストバリエーションで、超長テキスト入力をサポート。ドキュメント分析や長文要約に適している。

モデル選択時には、実際のニーズに基づいて性能、速度、コストを比較検討してください。ほとんどのシナリオでは、qwen-plusが良い出発点です。

中国語シナリオでの利点

Qwenは以下の中国語シナリオで特に優れたパフォーマンスを発揮します。

中国語の創作文：詩、随筆、小説、その他の文芸創作。
中国語の知識Q&A：中国の歴史、文化、法律などの専門的な質問。
中英翻訳：高品質な双方向の中英翻訳。
コード生成：中国語のコメントとドキュメント付きのコード生成。

フェイルオーバーチェーンの設定

高可用性を確保するために、Qwenのフェイルオーバーを設定することを推奨します。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen/qwen-max",
        "fallback": "openrouter/qwen/qwen-2.5-72b-instruct"
      }
    }
  }
}

Alibaba CloudのAPIに直接問題が発生した場合、バックアップチャンネルとしてOpenRouterを通じてQwenモデルにアクセスできます。

注意事項

Qwenモデルを使用する際に留意すべき点がいくつかあります。

地域制限：DashScope APIサーバーは中国本土にデプロイされているため、海外からのアクセスはレイテンシが高くなる場合がある。
コンテンツコンプライアンス：Qwenモデルは中国本土のコンテンツ審査基準に従っており、特定のセンシティブなトピックへの応答が制限される場合がある。
課金：DashScopeはトークン数で課金され、モデルごとに単価が異なる。コンソールで使用量を監視することを推奨。

確認とテスト

設定完了後、中国語のテストメッセージを送信してQwenが正しく応答することを確認してください。古典中国語の翻訳や慣用句の説明など、中国語固有のタスクを試して、Qwenの中国語能力を体験してください。OpenClawのログを確認して、リクエストがQwenプロバイダーに正しくルーティングされていることを確認してください。