Hermes v2026.3.28 アップデート：Telegram セットアップが簡単に

Telegram は、Hermes Agent とチャットする最も人気のある方法のひとつです。今回のアップデートでは、セットアッププロセスを改善し、便利な新オプションをいくつか追加しました。完全な初心者でも熟練のプロでも、このガイドで簡単にエージェントとチャットを始められます。

ステップ 1：ボットを作成する

まず最初に、ボットトークンが必要です。これは Hermes がボットを制御するための秘密の鍵のようなものです。取得方法は以下のとおりです：

Telegram を開いて @BotFather を検索（または t.me/BotFather にアクセス）
/newbot を送信
表示名を決める（好きな名前でOK。例：「Hermes Agent」）
bot で終わるユーザー名を選択（例：my_hermes_bot）
BotFather が API トークンを返信します

トークンは次のような形式です：

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

重要： このトークンは秘密にしてください！トークンを知っている人は誰でもボットを制御できてしまいます。万一漏洩した場合は、BotFather で /revoke を実行して直ちに無効化してください。

ステップ 2：ボットをカスタマイズする（任意ですが推奨）

BotFather の簡単なコマンドで、ボットをよりユーザーフレンドリーにできます：

コマンド	目的
`/setdescription`	チャット開始前に表示される「このボットは何ができる？」のテキスト
`/setabouttext`	ボットのプロフィールページに表示される短いテキスト
`/setuserpic`	アバター画像のアップロード
`/setcommands`	`/` コマンドメニューの定義
`/setprivacy`	グループメッセージの可視性の制御（ステップ 3 を参照）

/setcommands の良い初期設定は次のとおりです：

help - ヘルプ情報を表示
new - 新しい会話を開始
sethome - このチャットをホームチャンネルに設定

新機能：オンライン/オフラインステータス表示

Telegram ボットには、ユーザーアカウントのような緑色の「オンライン」ドットがありません。しかし、今回からボットのプロフィール説明文にステータスを表示できます！設定ファイルで有効にしてください：

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 オンライン"
        status_offline: "🔴 オフライン"

ゲートウェイが接続されるとステータスは オンライン に、正常にシャットダウンすると オフライン に更新されます。これはグローバル（全員に表示）であり、クラッシュ時には更新されないことに注意してください — これは Telegram の制限です。

新機能：コマンドメニューの優先順位

Hermes はゲートウェイ起動時にコマンドメニューを自動的に登録します。デフォルトでは信頼性のため 60 コマンドに制限されています（Telegram は最大 100 まで許可していますが、大きなペイロードは失敗する可能性があります）。どのコマンドを先に表示するかカスタマイズできます：

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

prepend：自分のコマンドを先に、その後に Hermes のデフォルト
append：Hermes のデフォルトを先に、その後に自分のコマンド
replace：優先順位付けに自分のリストのみを使用

ステップ 3：プライバシーモード — 最大の落とし穴

これが最も混乱しやすいポイントです。Telegram ボットは デフォルトでプライバシーモードが有効 になっています。つまり、ボットは次のものだけを認識できます：

/ で始まるメッセージ
自分のメッセージへの返信
サービスメッセージ（参加、退出、ピン留め）
管理者になっているチャンネルのメッセージ

プライバシーモードが OFF の場合、ボットはグループ内のすべてのメッセージを認識できます。

無効にする方法：

@BotFather にメッセージを送信
/mybots を送信
自分のボットを選択
Bot Settings → Group Privacy → Turn off に移動

警告： この設定を変更した後は、ボットをグループから削除して再追加する必要があります。Telegram はプライバシー状態をキャッシュしているためです！

代替案： ボットを グループ管理者 に昇格させる — 管理者は常にすべてのメッセージを認識できるため、プライバシートグルは不要です。

新機能：自動返信なしでグループの会話を監視

ボットにグループメッセージを「見る」だけで、メンションされたときだけ「応答」させたいですか？この新モードはまさにそのためのものです：

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

これを有効にすると、許可リストに登録されたチャットからのメンションなしメッセージがセッションのトランスクリプトにコンテキストとして追加されますが、エージェントはトリガーされません。後で @botname でメンションすると、それまでに話された内容の完全なコンテキストが利用できます。

まとめ

以上です！これで、どこからでも Telegram で Hermes Agent とチャットする準備が整いました。新しいステータスインジケーター、コマンドメニュー制御、グループ監視モードにより、これまで以上に柔軟に利用できます。楽しいチャットを！