LightVela

チャンネルを設定 - Telegram

概要

Telegram チャンネルはボットトークンを使用して接続されるため、Hermes Agent を Telegram のダイレクトメッセージやグループに素早く導入する方法として便利です: Telegram で BotFather を通じてボットを作成し、そのボットトークンをコピーして LightVela コンソールのチャンネルセクションに貼り付けます。Telegram アカウントと設定済みモデル(またはプランに含まれる月間モデルクレジット)が必要です。ボットトークンは機密資格証明であるため、公開しないでください。接続されると、Telegram のエージェントは他のチャンネルと同じペルソナおよび長期メモリを共有します。


Telegram チャンネルはボットトークンアクセスを使用しており、Hermes Agent を Telegram のプライベートチャットやグループに素早く接続するのに適しています。

このページの内容

  • コードをスキャンするか、携帯電話でTelegramのリンクを開いてアクセスを承認する

  • TelegramでHermes Agentとチャットする


手順

1. コンソールに入る

LightVela にサインインし、右上の「My Hermes」をクリックしてコンソールに入り、「Channel」ボタンを見つけます。

2. Telegramチャンネルを選択する

Telegramカードを見つけて「+ 接続」をクリックする

3. Telegramを開く

  1. 携帯電話でTelegramアプリを開く

  2. @BotFatherを検索してチャットを開く

  1. /startを送信する

  2. /newbotを送信する

  3. エージェントの名前を入力してください: ユーザー名は一意で、最後が「bot」で終わる必要があります

  4. HTTP APIトークンをコピー:

4. HTTP APIトークンをTelegramに貼り付けます

HTTP APIトークンをトークン欄に貼り付けます。

5. 新しいボットとTelegramでチャットする

BotFatherから提供されたリンクをクリックして、ボットとのやり取りを開始してください。

ボットとのチャットを開き、テストメッセージを送信します:

Hi

数秒以内にHermes Agentの返信が届くはずです。

6. 任意:BotFatherでグループメッセージを有効にする

ボットをグループで使用したい場合のみ、ステップ6と7を完了してください。 ステップ5の後、ダイレクトメッセージはすでに利用可能です。

  1. Telegramで@BotFatherを開きます。
  2. /mybotsを送信します。
  3. あなたのHermes Agentに接続されているボットを選択します。
  4. 「ボット設定」を開きます。
  5. 「グループプライバシー」を選択します。
  6. 「オフにする」または「プライバシーモードを無効にする」を選択します。

7. オプション: グループにボットを追加してテストする

  1. 使用したいTelegramグループを開きます。
  2. 「メンバーを追加」または同等のグループ管理操作を選択します。
  3. ユーザー名でボットを検索し、グループに追加します。
  4. @bot_usernameでメンションしてテストメッセージを送信します。

グループプライバシーが無効になると、ボットは自分がメンションされたグループメッセージを受信して返信できるようになります。


成功状態

  • コンソールの「接続されたチャンネル」リストには「Telegram」が含まれています。

  • 対応するボットはTelegramの連絡先に見つけることができます

  • メッセージを送信するとHermes Agentが返信します

  • Hermes Agentは、ボットに言及して追加されたグループ内でメッセージを送信すると返信します


サポートされているメッセージタイプ

アクセスが成功した後、Telegramボットは基本的なテキストメッセージを受信および返信でき、次のような他のメッセージタイプもサポートします:

Telegramボットがサポートするメッセージタイプサポート状況
テキストメッセージの受信✅ サポート
画像および動画の受信✅ サポート
ファイルの受信✅ サポート
テキストメッセージで返信✅ サポート
画像および動画で返信✅ サポート
ファイルで返信✅ サポート
メッセージを積極的に送信(例:スケジュールされたリマインダー)✅ サポート

FAQ

問題考えられる原因解決策
BotFatherはボットを作成できませんボット名またはユーザー名がTelegramの要件を満たしていません表示名は何でも構いませんが、ユーザー名はbotで終わる必要があります。例: my_hermes_bot
BotFatherはHTTP APIトークンを返しませんでした作成フローが完了していませんBotFatherのチャットに戻り、再び/newbotを実行して、名前とユーザー名を設定するための指示に従ってください
貼り付けた後、トークンが無効と表示されますトークンが不完全であるか、余分なスペース/改行が含まれていますBotFatherから完全なHTTP APIトークンを再コピーして、トークン欄に貼り付けてください
アクセスをクリックしても応答がないネットワーク遅延または認証が完了していないコンソールをリフレッシュしてステータスを確認してください。アクセスが成功しなかった場合は、再度試してください
Telegramでボットが見つからないBotFatherが提供したリンクをクリックしていない、またはチャットを開始していないBotFather が提供したリンクをクリックし、次にボットページで「開始」をクリックします
メッセージ送信後に応答がありませんモデルが設定されていない、試用クレジットが使い果たされた、またはボットが正常に接続されていません「1. モデル」カードで「現在のモデル」のステータスを確認し、Telegram チャンネルが接続済みであることを確認します
ボットはグループメッセージを受信できませんグループプライバシーがまだ有効、ボットがグループに追加されていない、またはメッセージで言及されていないBotFatherで/mybotsを送信し、ボットを選択してから「Bot設定」→「グループのプライバシー」を開き、プライバシーモードをオフにします。ボットをグループに追加し、@bot_usernameでテストメッセージを送信します。
リンク解除方法「接続済みチャンネル」リストで対応するTelegramの記録を削除します。
同じTelegramボットが複数のHermes Agentインスタンスに接続できますか?推奨されません。1つのボットトークンは1つのHermes Agentに紐付けるべきです複数のHermes Agentインスタンスが必要な場合は、別々のTelegramボットを作成してください。

チャンネルノート

  • メッセージタイプ: テキスト、画像、動画、ファイル、音声メッセージなどをサポートします。詳細は上記の「サポートされているメッセージタイプ」を参照してください

  • グループチャットのサポート: BotFatherでグループプライバシーを無効にし、ボットをグループに追加し、@bot_usernameで会話を開始した後に、グループメッセージがサポートされます。

  • 接続の中断: 長時間応答がない場合は、認証が取り消された可能性があります。コンソールに戻り、再度アクセスを許可してください


次のステップ

最終更新日: 2026-08-28