Skip to Content
ユーザーガイド機能チャンネルWeCom (Enterprise WeChat)

WeCom (Enterprise WeChat)

本ガイドでは、WeCom インテリジェントロボット（企业微信智能机器人）と Qwen Code を連携させる設定方法について説明します。

前提条件

  • WeCom の組織アカウント
  • API モードで作成された WeCom インテリジェントロボット
  • ロボットの Bot ID と Secret

ロボットの作成

  1. WeCom 管理コンソールを開き、インテリジェントロボットを作成します。

  1. API モードを選択します。

  1. Bot ID と Secret をコピーします。
  2. ロボットを利用させたいダイレクトチャットまたはグループに追加します。

インテリジェントロボットは、Qwen Code から WeCom への WebSocket 接続を使用します。公開コールバック URL、Token、EncodingAESKey、Corp ID、Agent ID は必要ありません。

設定

チャネルを ~/.qwen/settings.json に追加します。

{
  "channels": {
    "my-wecom": {
      "type": "wecom",
      "botId": "$WECOM_BOT_ID",
      "secret": "$WECOM_SECRET",
      "senderPolicy": "allowlist",
      "allowedUsers": ["zhangsan"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise coding assistant responding via WeCom.",
      "groupPolicy": "open"
    }
  }
}

認証情報を環境変数として設定します。

export WECOM_BOT_ID=<your-bot-id>
export WECOM_SECRET=<your-secret>

または、settings.json の env セクションで定義します。

{
  "env": {
    "WECOM_BOT_ID": "your-bot-id",
    "WECOM_SECRET": "your-secret"
  }
}

実行

qwen channel start my-wecom

WeCom を開き、インテリジェントロボットにメッセージを送信します。

アクセス制御

senderPolicy は他の IM チャンネルと同じように機能します。

  • allowlist: allowedUsers に含まれるユーザーのみがボットを使用できます。これは推奨される企業のデフォルト設定です。
  • pairing: ボットを使用する前に、ユーザーはペアリングを行う必要があります。
  • open: ロボットにメッセージを送信できる誰でも使用できます。

グループの場合、groupPolicy を "allowlist"、"pairing"、または "open" に設定します。"pairing" の場合、グループの最初のメンションがペアリングリクエストを作成し、応答が開始される前に一度承認される必要があります。groupPolicy: "pairing" の場合、アクセスはグループごとに付与される点に注意してください。グループが承認されると、そのグループのどのメンバーでもボットを使用できます。senderPolicy と allowedUsers は承認されたグループのメンバーを制限しません。WeCom はインテリジェントロボットにメンションされたグループメッセージのみを配信するため、配信されたグループコールバックはすべてメンション付きとして扱われます。requireMention 設定は、メンションなしのグループメッセージへの応答を有効にできません。そのようなメッセージはボットに配信されないためです。

グループメンションの互換性

以前の Qwen Code バージョンでは、WeCom がグループコールバックを配信した後に汎用の requireMention ゲートも適用されていました。コールバックには個別のメンションメタデータが含まれていないため、requireMention: true（デフォルト値を含む）は配信されたすべてのグループメッセージを拒否し、グループチャットが機能していないように見える可能性がありました。

Qwen Code は現在、WeCom のメンションスコープの配信に依存し、2 回目のメンション判定は適用しません。requireMention: true または requireMention: false を含む既存の WeCom 設定は有効なままであり、設定エラーを発生させません。どちらの値も WeCom では同じ動作をするため、このフィールドは削除できます。同じグループエントリ内の他の設定（dispatchMode など）は引き続き適用されます。groupHistoryLimit は引き続き受け付けられますが、メンションなしのグループメッセージは配信されないため、新しい WeCom 履歴を収集できません。

画像とファイル

ユーザーはテキスト、文字起こし付き音声メッセージ、画像、テキストと画像の混合、ファイル、動画を送信できます。画像は画像添付ファイルとしてエージェントに渡されます。ファイルと動画は一時ローカルパスにダウンロードされるため、エージェントはファイルツールを使用してそれらを読み取ることができます。

アシスタントの応答は WeCom の Markdown として送信されます。エージェントによって生成されたローカル画像を送信するには、コードブロックの外にマーカーを 1 つ含めます。

[IMAGE: /absolute/path/to/image.png]

セキュリティのため、ローカル画像のパスは、Linux の /tmp/channel-files/... などのシステム一時ディレクトリ下にあるチャネルファイルディレクトリ内にある必要があります。モデルが生成するファイルパスによって任意のワークスペースファイルがアップロードされるのを防ぐため、汎用ファイル、動画、音声のアップロードマーカーは無視されます。

トラブルシューティング

ボットが接続されない

  • Bot ID と Secret を確認します。
  • ロボットが API モードで作成されていることを確認します。
  • qwen channel start を実行しているシェルで環境変数が利用可能であることを確認します。

ボットがグループで応答しない

  • groupPolicy を確認します。
  • グループ内でボットにメンションを付けます。
  • ロボットがグループに追加されていることを確認します。

自作アプリケーションの認証情報が機能しない

このチャンネルは WeCom インテリジェントロボット用のものです。Corp ID、Agent ID、Token、EncodingAESKey などの自作アプリケーションのコールバック認証情報は、このチャンネルでは使用されません。

Last updated on
QQ Bot (QQ机器人)フック