QQ ボット
QQ オープンプラットフォームでボットを登録し、BotAppID と Token を StoryClaw コンソールにバインドして、AI メンバーを QQ グループに参加させます。
概要
QQ ボットの統合には、QQ オープンプラットフォームでボットアカウントを登録し、BotAppID と Token を取得して、StoryClaw コンソールに入力する必要があります。
QQ ボットは現在 QQ グループチャットのみをサポートしています。個人チャットのサポートはまだ利用できません。
前提条件
- QQ オープンプラットフォーム で開発者認証を完了していること
- StoryClaw コンソールで少なくとも 1 つの AI メンバーを作成し、アクティブ化していること
セットアップ手順
1. QQ オープンプラットフォームでボットを作成
q.qq.com にログインし、「ボット」管理ページに移動して「ボットを作成」をクリックし、ボット名と説明を入力し、「グループボット」タイプを選択して、申請を送信します。

2. BotAppID と Token を取得
ボットが作成されたら、ボット詳細ページの「開発者設定」に移動し、BotAppID をコピーして、Token(Bot Token)を生成またはコピーします。

3. コンソールに認証情報を入力
StoryClaw コンソール → ClawBot デバイス → プラグイン → QQ Bot に移動し、BotAppID と Token を対応するフィールドに貼り付けて、バインドする AI メンバーを選択し、「保存」をクリックします。
4. ボットを QQ グループに追加
QQ オープンプラットフォームでボットの審査が通過して公開されたら、その QQ 番号を使ってグループに招待します。グループ内でボットを @メンションすると、AI メンバーの応答がトリガーされます。
トラブルシューティング
Q: ボットがグループで応答しない
A: コンソールで Token が設定されていること、ClawBot デバイスがオンラインであることを確認してください。応答するにはボットを @メンションする必要があります。
Q: Token の検証に失敗した
A: QQ オープンプラットフォームで Token を再生成し、コンソールで更新してください。