QQ Bot — QQ 中的 AI | Easy Understand Hermes Agent

想像してみてください。あなたのお気に入りのグループチャットに、突然、質問に答えたり、ボイスメッセージを要約したり、さらには整形された返信まで送ってくれる超賢い友達が現れたら——それがまさに、Hermes Agent が QQ にもたらすものです。

これは何？

Hermes Agent は、AI アシスタントをメッセージングプラットフォームに接続できるオープンソースのフレームワークです。QQ Bot アダプター は、Hermes と QQ 公式ボット API の間をつなぐ橋渡し役です。プライベートチャット、グループ @メンション、ギルドチャンネルなどのメッセージをリッスンし、自動的に応答します。セットアップ以外のコーディングは一切不要です。

仕組み（わかりやすく説明）

新しい電話を設定するのと同じだと考えてください。

ボットの身分を取得する – q.qq.com でボットを登録し、App ID と App Secret を受け取ります（ボットのユーザー名とパスワードのようなものです）。
配線を接続する – Hermes は QQ のゲートウェイへの永続的な WebSocket 接続を開き、メッセージを即座に受け取ります。
リッスンを教える – 参加できる会話（プライベート DM、グループメンション、ギルドチャンネル）を決定します。
返信させる – 誰かがメッセージを送信すると、Hermes がそれを処理し、テキストまたはリッチなマークダウンで返信します。

ステップバイステップのセットアップ

1. 依存関係をインストールする

pip install aiohttp httpx

2. ボットを設定する（最も簡単な方法）

hermes gateway setup

QQ Bot を選択し、プロンプトに従ってください。App ID と Secret を求められます。

3. 手動設定（お好みの場合）

~/.hermes/.env を作成または編集します。

QQ_APP_ID=your-app-id
QQ_CLIENT_SECRET=your-app-secret

これが最小限の設定です。より細かく制御するには、~/.hermes/config.yaml を編集します。

platforms:
  qqbot:
    enabled: true
    extra:
      markdown_support: true
      dm_policy: "open"   # open | allowlist | disabled
      group_policy: "open"

注目機能：ボイスメッセージ

QQ は、すべてのボイスメッセージに対して無料の文字起こし（Tencent の ASR）を提供します。それが失敗した場合、Hermes は GLM-ASR や OpenAI Whisper などのカスタム STT プロバイダーにフォールバックできます。つまり、ボットは音声メモを「聞いて」、テキストの要約で返信できるのです。

知っておくべきセキュリティ設定

QQ_ALLOWED_USERS – DM を特定の OpenID に制限します（デフォルト：全員）
QQ_GROUP_ALLOWED_USERS – グループアクセスを特定のグループ OpenID に制限します
dm_policy / group_policy – 厳格に制御する場合は "allowlist" に設定し、そのチャンネルを完全に無効にする場合は "disabled" に設定します

まとめと実用的なヒント

Hermes を QQ に接続することは、グループチャットにパーソナルアシスタントを与えるようなものです。セットアップには約10分かかり、その後は、誰が話しかけられるかから、マークダウンや音声文字起こしをサポートするかどうかまで、すべてをカスタマイズできます。

初心者への私のヒント： サンドボックスモード（QQ_PORTAL_HOST=sandbox.q.qq.com を設定）から始めましょう。最初に自分のアカウントでテストし、その後、徐々に友達に開放していきます。そして、公開する前に必ず QQ_ALLOWED_USERS を自分の OpenID に設定してください。初日から見知らぬ人にボットとチャットされては困りますからね。

稼働したら、長いボイスメッセージを要約したり、簡単なアナウンスを整形したりするようにボットに頼んでみてください。そこで、その魔法を実感できるはずです。