Langflow を Telegram に接続する
LangBot で Langflow アプリを Telegram のボットとして動かす手順:Langflow の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。
このレシピではお使いの Langflow アプリを Telegram のボットにつなぎます。LangBot が Telegram のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。
Langflow はドラッグ&ドロップでエージェントやフローを作れます。LangBot はメッセージごとに Langflow API でフローを実行します。
必要なもの
- 稼働中の LangBot:LangBot Cloud(サーバー不要)、または Docker や
uvx langbotによるセルフホスト。 - LangBot からネットワーク経由で到達できる Langflow のアカウントまたはインスタンス。
- @BotFather で取得したボットトークン(
/newbotを送り、botで終わるユーザー名を付けます)。
ネットワーク
Telegram はロングポーリングを使うため、LangBot から api.telegram.org へ外向きに接続できれば十分です。公開 Webhook URL は不要で、手元の PC や自宅サーバーでも動きます。
1. Langflow を準備する
- Langflow でフローを作成します(Simple Agent テンプレートから始めると簡単です)。
- Settings で API キーを作成します。
- Share → API access のサンプルコードから Flow ID を取得します。
2. パイプラインを作成する
LangBot WebUI の パイプライン でパイプラインを作成(または既定のものを編集)し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケット から公式ランナープラグインをインストールします。
| 項目 | 設定値 |
|---|---|
| ランナー | Langflow(公式 Langflow Agent ランナープラグイン) |
| Base URL | LangBot から到達できる Langflow のアドレス |
| API Key | Langflow の API キー |
| Flow ID | 実行するフローの ID |
3. Telegram のボットを作成する
- ボット で新しいボットを作成し、Telegram アダプター(LangBot 4.11 の新しいアダプター。非推奨の旧版は選ばない)を選びます。
- トークンを貼り付け、必要に応じて Markdown とストリーミングを有効にし、ボットを有効化して保存します。
4. 紐付けてテストする
ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。
ボットとの個人チャットで Start を押してからメッセージを送ります。グループではパイプラインのトリガー条件(ボットへのメンションや返信など)を満たす必要があります。
トラブルシューティング
- 接続が拒否される場合、
http://localhost:7860が使えるのは Langflow と LangBot が同じホスト・同じネットワーク名前空間にあるときだけです。 - 1 つのトークンをポーリングできるのは 1 インスタンスだけです。返信がない場合は、同じボットを別の LangBot インスタンスやスクリプトで有効にしていないか確認してください。
- WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。
よくある質問
Telegram には公開 IP のあるサーバーが必要ですか?
いいえ。Telegram はロングポーリングを使うため、LangBot から api.telegram.org へ外向きに接続できれば十分です。公開 Webhook URL は不要で、手元の PC や自宅サーバーでも動きます。
Telegram のボットはストリーミング返信に対応していますか?
はい。ボットでストリーミングを有効にし、AI 側もストリーミングに対応している必要があります。詳しくはプラットフォーム機能一覧をご覧ください。
同じ Langflow の設定を他のプラットフォームでも使えますか?
はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。
関連ガイド
- Telegram の詳しい設定ガイド
- Langflow ランナーの詳しいガイド
- Telegram で使える他の AI:Dify · n8n · Coze · DeepSeek · OpenAI (ChatGPT models)
- Langflow を他のプラットフォームで使う:Discord · Slack · Lark(Feishu) · DingTalk · WeCom(社内アプリ) · WeCom インテリジェントボット
