n8n を QQ 公式ボットに接続する

LangBot で n8n アプリを QQ 公式ボットのボットとして動かす手順：n8n の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。

このレシピではお使いの n8n アプリを QQ 公式ボットのボットにつなぎます。LangBot が QQ 公式ボットのメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。

n8n がワークフローを実行し、LangBot がチャットプラットフォーム、セッション、配信を担当します。メッセージごとに Webhook でワークフローを呼び出します。

必要なもの

稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
QQ オープンプラットフォームで登録したボット：AppID、Token、AppSecret。LangBot サーバーの IP を IP ホワイトリストに追加します。

QQ 公式ボット API（Webhook）には公開 IP と HTTPS が必要です。LangBot Cloud には公開ドメインがあります。

ワークフローを Webhook または On chat message トリガーで開始します。ストリーミング返信には Response Mode を Streaming にします。
AI Agent ノード（ストリーミング）か Respond to Webhook ノードで応答し、応答キー名を LangBot の出力キー名と一致させます。
Active でワークフローを有効にし、本番用 Webhook URL をコピーします。

LangBot WebUI の パイプライン でパイプラインを作成（または既定のものを編集）し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケットから公式ランナープラグインをインストールします。

項目	設定値
ランナー	n8n（公式 n8n ワークフローランナープラグイン）
Webhook URL	ワークフローの本番用 Webhook URL
認証方式	なし、Basic Auth、JWT、Header のいずれか（トリガーノードと同じ設定）

QQ 公式 アダプターでボットを作成し、AppID、Token、AppSecret を入力します。
ボットの Webhook コールバック URL をコピーし、ホストを HTTPS ドメインに置き換えて QQ 管理ポータルのリクエストアドレスに保存します。サンドボックス設定でテストユーザーを追加します。

ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。

サンドボックスのメンバーとしてボットに個別チャットするか、サンドボックスのグループでメンションします。