OpenClaw QQ ボットチャンネル
コミュニティプラグインを通じてOpenClawをQQに接続します（QQはOpenClaw公式内蔵チャンネルではありません）。この統合は、ダイレクトメッセージ、グループチャット（@トリガー）、チャンネルメッセージ、チャンネルDM、リッチメディア（画像、音声、動画、ファイル）、音声テキスト変換、予約メッセージ、Markdownフォーマット、引用メッセージコンテキストをサポートしています。プラグインをインストールし、QQオープンプラットフォームでBotを作成し、認証情報を設定すれば稼働開始できます。
QQ 対応機能
テキストメッセージ
対応
メディア・ファイル
対応
リアクション
非対応
スレッド
非対応
音声メッセージ
対応
グループチャット
対応
QQ 前提条件
- QQオープンプラットフォームの開発者アカウント
- QQプラグインのインストール：openclaw plugins install @openclaw-china/qqbot
- OpenClaw Gatewayが稼働・設定済みであること
- サーバーにNode.js 18+がインストール済みであること
QQ クイックセットアップ
QQプラグインのインストール
ターミナルで 'openclaw plugins install @openclaw-china/qqbot' を実行し、Tencent公式メンテナンスのQQボットプラグインをインストールします。このプラグインはGitHubで186のスターがあります。
QQオープンプラットフォームでBotを作成
QQオープンプラットフォーム（q.qq.com）にログインし、新しいBotアプリケーションを作成します。アプリ設定ページでAppIDとClientSecretの認証情報を取得します。これらはOpenClawとQQを接続するために必要です。
権限を設定
QQオープンプラットフォームの権限管理ページで、Botに必要な権限を設定します。ダイレクトメッセージ、グループチャット、チャンネルメッセージなどの関連権限、およびメディアメッセージ送信権限を有効にします。完了後、審査に提出します。
OpenClawを設定してテスト
推奨：'openclaw china setup' を実行してインタラクティブセットアップウィザードを起動します。または ~/.openclaw/openclaw.json にQQチャンネル設定を追加し、appIdとclientSecretを入力します。'openclaw gateway restart' を実行してGatewayを再起動し、QQでBotにメッセージを送信して正常に動作するかテストします。
QQ 設定例
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "your-app-id",
"clientSecret": "your-app-secret",
"sandbox": false,
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}QQ 統合ガイド
OpenClaw QQ アーキテクチャ概要
OpenClaw QQ プラグインのインストール
# QQプラグインのインストール
openclaw plugins install @openclaw-china/qqbot
# インストールの確認
openclaw plugins list
# プラグインの更新
openclaw plugins update @openclaw-china/qqbot
# インタラクティブセットアップウィザードを起動
openclaw china setupOpenClaw QQ Botの作成
# 環境変数で設定
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"
# またはCLIで設定
openclaw channels addOpenClaw QQ メッセージタイプとメディアサポート
OpenClaw QQ グループチャットとチャンネル設定
{
"channels": {
"qqbot": {
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}OpenClaw QQ 便利なコマンド
QQ 設定リファレンス
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | QQチャンネルの有効・無効を切り替え |
| appId | string | "" | QQ BotのAppID、QQオープンプラットフォームから取得 |
| clientSecret | string | "" | QQ BotのClientSecret、QQオープンプラットフォームから取得 |
| sandbox | boolean | false | サンドボックスモードを有効化、開発・テスト環境用 |
| dmEnabled | boolean | true | ダイレクトメッセージへの返信を有効化 |
| groupEnabled | boolean | true | グループチャットメッセージへの返信を有効化（@トリガーが必要） |
| channelEnabled | boolean | true | QQチャンネルメッセージへの返信を有効化 |
| messageFormat | string | "markdown" | 返信メッセージのフォーマット。オプション：text（プレーンテキスト）、markdown |
| debug | boolean | false | デバッグモードを有効化、接続とメッセージの詳細ログを出力 |
QQチャンネルの有効・無効を切り替え
QQ BotのAppID、QQオープンプラットフォームから取得
QQ BotのClientSecret、QQオープンプラットフォームから取得
サンドボックスモードを有効化、開発・テスト環境用
ダイレクトメッセージへの返信を有効化
グループチャットメッセージへの返信を有効化（@トリガーが必要）
QQチャンネルメッセージへの返信を有効化
返信メッセージのフォーマット。オプション：text（プレーンテキスト）、markdown
デバッグモードを有効化、接続とメッセージの詳細ログを出力
QQ よくある質問
QQ トラブルシューティング
AppIDまたはClientSecretが正しくない、プラグインが正しくインストールされていない、またはBotがプラットフォームの審査を通過していない。
QQサーバーにはアクティブメッセージのフィルタリング機能があり、返信タイプでないメッセージがブロックされる可能性がある。
メディアメッセージ関連の権限が不足しているか、ファイルサイズがQQプラットフォームの制限を超えている。
channelEnabledが有効になっていない、またはBotがQQチャンネルに追加されていない。
音声認識サービスの異常または権限不足。