AIエージェントTelegramボット用プラグイン：インストールと確認

私のエージェントはサーバー上で動いていて、Telegramから指示を出します。チャットに書き込むと、エージェントはファイルを読み、タスクを実行して、結果を送ってくれます。ある時点で限界にぶつかります。基本的なボットにできることはほとんどなく、コードレビューやGitHubへのコミット、定期的な要約の作成を任せたくなるのです。その答えがプラグインです。

まさにこのために、「Telegramにプラグインをインストールする方法」が検索されています。ステッカーのストアの話ではありません。ボットに新しい機能を与える方法を知りたいのです。以下では、プラグインとは何か、実際にはどこにインストールするのか、5分でインストールする方法、そして悪意のあるコードをエージェントに持ち込まない方法を順を追って説明します。この解説は公式ドキュメントに基づいています。

Ailootの活用に関する実用的な情報はドキュメントにあります。

AIエージェントのプラグインとは？簡単に言うと#

もう少し詳しく見てみましょう。AIエージェントは、最初からファイルを読んだり、コードを書いたり、質問に答えたりする基本的なことができます。プラグインは、追加機能をまとめたフォルダーで、エージェントがそれを取り込み、使い始めます。Claude Codeの公式ドキュメントも、プラグインを、スキル、個別のヘルパーエージェント、自動アクション、外部サービスへの接続によってエージェントを拡張するものと説明しています。

簡単な例を挙げましょう。GitHub連携用のプラグインをインストールすると、エージェントにはコミットの作成、プルリクエストのオープン、変更履歴の確認を行うコマンドが追加されます。レビュー用のプラグインをインストールすると、あらかじめ決められたチェックリストに沿って、コードのエラーやセキュリティ上の穴を確認してくれます。これらを手作業で設定する必要はありません。プラグインの作者がすべてまとめているので、あなたは接続するだけです。

もう1つ大切なことがあります。プラグインを入れても、エージェントに何かが「永遠に」身につくわけではありません。取り外せるモジュールです。今日接続して明日切断すれば、ボットはプラグイン導入前の機能セットに戻ります。だから、プラグインは気軽に試せます。1つ選んで実際のタスクで使い、役に立たなければ痕跡を残さず削除できます。

プラグインはスキル、MCP、サブエージェントとどう違う？#

エージェントに関する用語は混乱しやすいので、違いを表にまとめました。初めての人が抱く疑問の半分は、この表で解決できます。

Claude Codeでは、外部サービスへの接続をMCPと呼びます。エージェントがGitHub、データベース、ブラウザーにアクセスできるようにする標準です。表の最初の4項目は、それぞれ独立した部品です。

一番下の行を見てください。プラグインは、ほかの4つより1段上にあります。スキル、ヘルパー、自動アクション、MCPを1つの箱にまとめます。作者がすべてを組み合わせ、説明ファイルを加えて公開しています。4つの部品を個別に組み立てる代わりに、1つのコマンドで完成品を使えます。

選び方は簡単です。タスクに必要な小さな機能が1つだけなら、自分でスキルを書けばよく、15分でできます。すでに同じ問題を解決した人たちが作ったセットが必要なら、プラグインを使いましょう。Claude Code用スキルの選び方については、エージェントに余分なスキルを詰め込みすぎない方法も含め、別のガイドで説明しています。

「Telegramにプラグインをインストールする」とは？Telegramはどう関係する？#

ここでよくある誤解が生じます。Telegram自体にはプラグインはありません。メッセンジャーがボットの機能を保存するわけではなく、あなたのメッセージをエージェントに渡して返信を表示するだけです。頭脳にあたる部分は別の場所、つまりあなたのノートパソコンや、Hermes Agent、OpenClaw、またはチャットに接続したClaude Codeのようなエージェントが動くサーバーにあります。

プラグインのインストール方法は2つあり、どちらでも使えます。

1. チャットから直接インストールする。 Telegramでエージェントに「GitHubプラグインを自分にインストールして」と普通の言葉で頼みます。エージェントは自分のマシンにインストールし、準備ができたと返信します。サーバーが遠くにあり、スマートフォンを使っているときに便利です。
2. ターミナルからインストールする。 エージェントが動いているマシンにログインし、そこでコマンドを使ってプラグインをインストールします。初回はこの方法のほうが確実です。出力をすべて確認でき、見落としがありません。

どちらを選ぶかは、ボットに拡張機能を自分で監督なしにインストールさせてよいか、どのくらい信頼しているかによります。私は最初のプラグインをターミナルで手動インストールし、何が接続されるのかを正確に確認しました。慣れてからは、チャットでエージェント自身にインストールさせるようになりました。以下では両方の方法を紹介します。

エージェントにプラグインを5分でインストールするには？#

手順がドキュメントにそのまま記載されていて、簡単に再現できるClaude Codeを例に説明します。コマンドは、ターミナルで入力する場合も、Telegramでエージェントに送る場合も同じです。

1. プラグイン一覧を開く。 /pluginコマンドを実行すると、ターミナル内にパネルが開きます。利用可能な拡張機能がすべて表示されるタブと、claude.com/pluginsのディレクトリがあります。インストール前に一覧を見られるストアです。
2. 公式マーケットプレイスを接続する。 /plugin marketplace add anthropics/claude-plugins-officialと入力します。マーケットプレイスは、エージェントがプラグインをダウンロードするためのディレクトリです。公式マーケットプレイスはAnthropicが運営しています。
3. 必要なプラグインをインストールする。 プラグイン名の後に、アット記号で区切ってマーケットプレイス名を指定します。

/plugin install github@claude-plugins-official

4. プラグインを再読み込みする。 インストール後にボットが“Run /reload-plugins to activate.”と表示したら、/reload-pluginsを実行します。再読み込みするまでは、現在の会話に新しいコマンドが表示されません。再読み込みで会話を再読込するという警告が出た場合は、/reload-plugins --forceとしてコマンドを再実行してください。

これで完了です。エージェントがプラグインのコマンドを使えるようになります。Claude Codeでは、たとえば/commit-commands:commitのようにプラグイン名を接頭辞として使うため、そのコマンドがプラグイン由来だとすぐ分かります。

ターミナルを使わずTelegramでボットにコマンドを送る場合、Claude Codeには対話型パネルを使わない単独のインストールコマンドclaude plugin installもあります。ドキュメントには1つ注意点があります。このコマンドを実行しても、すでに開いている会話にはプラグインが読み込まれません。エージェントは次回起動時か、/reload-pluginsの後にプラグインを認識します。つまり、インストール後にボットを再起動しなければ、新しいコマンドは使えません。

Hermes Agentでは、hermes toolsコマンドで拡張機能を有効・無効にし、スキルは専用のフォルダーに保存します。OpenClawも同様です。セットを接続してボットを再起動します。名前は違っても、流れは同じです。ソースを接続し、名前でインストールして、エージェントを再起動します。

プラグインはコンテキストエンジニアリングを構成する要素の1つです。最初のリクエストの前に、エージェントがどの機能をすぐ使える状態にしておくかを決めます。体系的に作業するには、AIクローン（スキルやプラグインにまとめたあなたの専門知識）＋Second Brain（プロジェクト知識の構造）＋コンテキストエンジニアリング（何をいつエージェントに渡すか）の組み合わせが役立ちます。AIが推測を始めないために欠かせない3つの柱です。

プラグインはどこで入手できる？どれを信頼できる？#

プラグインは他人のコードであり、エージェントと同じ権限、つまりファイル、ターミナル、サービスへのアクセス権を持ちます。だから、見栄えのよい説明よりも入手先のほうが重要です。信頼性が高い順に紹介します。

コミュニティマーケットプレイスからインストールするには、同様のコマンドを使いますが、マーケットプレイス名が異なります。/plugin install plugin-name@claude-community。ドキュメントによると、これらのプラグインは自動セキュリティチェックに合格し、コードの特定バージョンに固定されています。つまり、後から作者に変更を加えられることなく、チェック済みのものをそのまま入手できます。

インストール前に、Claude Codeは「Will install」セクションを表示します。プラグインが追加するコマンド、ヘルパー、スキル、自動アクション、接続の一覧です。必ず読んでください。たとえば、メモ用の拡張機能が、なぜかターミナルアクセスを要求しているといった点に気づく機会です。公式ドキュメントは、次のように明記しています。

簡単に言うと、公式および審査済みマーケットプレイスは安心して使うためのものです。GitHub上の無作為なリポジトリを使うのは、中身を読み、要求される権限がなぜ必要なのかを理解してからにしてください。サードパーティー製コードへの信頼はプラグインのインストールに限った話ではありません。バイブコーディングのセキュリティに関する記事で詳しく説明しています。

プラグインがインストールされ、Telegramで動いているか確認するには？#

「インストール済み」と表示されても、ボットが実際にプラグインを認識したとは限りません。1分かけて確認しましょう。次の手順に従ってください。

1. 一覧を確認する。 /pluginパネルをもう一度開くか、エージェントに利用可能なコマンドを表示するよう頼みます。新しいプラグインのコマンドが、Claude Codeではプラグイン名を接頭辞として一覧に表示されるはずです。
2. テスト用のタスクを頼む。 実際の作業ではなく、安全なものを選びます。GitHubプラグインをインストールしたなら、最新のコミットを表示するよう頼みます。レビュー用プラグインなら、小さなファイルを渡します。確認するのは1点です。新しい機能を使って、ボットがタスクを引き受けるかどうかです。
3. 普段使っているのと同じチャットから確認する。 Telegramからエージェントを操作しているなら、Telegramでテストコマンドを送ります。ターミナルではプラグインが見えていても、チャット上のボットがまだ再読み込みしていない場合があります。

プラグインはインストールされているのにコマンドが動かない場合、最もよくある原因は再読み込みを忘れたことです。インストールコマンドは成功していても、開いている会話のエージェントはまだ古い機能セットを使っています。/reload-pluginsを実行してください。それでも動かなければ、ボットを完全に再起動します。2つ目の原因は、別のマーケットプレイスからインストールしたことです。プラグイン名が一致していても、ディレクトリが違うため、接続済みのマーケットプレイスにはそのプラグインがないとエージェントが正しく伝えます。

チャットでボットが返信しても、新しいコマンドを理解しない場合、エージェントが壊れているわけでも、あなたが何か間違えたわけでもありません。ほとんどの場合、原因は2つのうちどちらかです。プラグインが再読み込みされていないか、間違ったマーケットプレイスに接続したかです。どちらも1分で直せます。

エージェントを散らかさずにプラグインを更新・削除するには？#

更新には、気づきにくい点があります。作者がプラグインの新バージョンを公開しても、自動では届きません。まず/plugin marketplace updateでマーケットプレイスのディレクトリを更新し、それから新しいバージョンをインストールします。マーケットプレイスを更新するまでは、エージェントは前回ダウンロードしたバージョンを最新と見なします。これは意図的な動作です。ほかの人の変更が、知らないうちに後から入り込むことはありません。

インストールしたときと同じ/pluginパネルからプラグインを削除します。インストール済み一覧でプラグインを見つけて削除してください。エージェントには痕跡が残らず、再読み込みするとコマンドも消えます。だから、プラグインを試すのは怖くありません。いくつかインストールし、うまくいった2つだけ残して、ほかは削除すればよいのです。

整理整頓も忘れずに。接続するプラグインが増えるたびに、エージェントが覚えておくコマンドが増え、説明のためにコンテキストウィンドウの一部が使われます。使わないプラグインが5つもあると、ボットの動作が遅くなり、余計な混乱を招きます。ルールは簡単です。2週間役に立っていないプラグインは削除しましょう。コマンド1つで戻せます。

まずどのプラグインをインストールする？#

トップ100のリストは紹介しません。これは別のガイドに値するテーマですし、すでにClaude Code用プラグイントップ10の記事を書いています。Telegramからエージェントを操作する初心者におすすめの分野を3つ紹介します。

1. GitHub連携。 コミット、ブランチ、プルリクエスト用のコマンドをエージェントに追加するプラグインです。チャットでボットに「作業を保存してリポジトリにプッシュして」と書けば、実行してくれます。経験のないままバイブコーディングをする人が最も心配する、コードを失う恐怖を軽減できます。
2. コードレビュー。 エラー、セキュリティ上の穴、弱点を調べるためのチェックリストを備えたプラグインです。Telegramとの組み合わせで特に便利です。チャットにコードの一部を送れば、エディターを開かずにレビューを受けられます。
3. 一貫したスタイルでのコミット。 エージェントが1つのテンプレートに従ってコミットを整形する小さなプラグインです。些細なことに見えるかもしれませんが、1か月後にはプロジェクトの履歴が、雑然とせずチームのように整って見えます。

それ以降は、個別のタスクに合わせてプラグインを選びます。データベースを扱いますか？データベース用プラグインを入れましょう。要約を作成しますか？スケジュール用プラグインを入れましょう。基本のルールは同じです。まずタスクがあり、それに合うプラグインを探します。「念のため」と前もってインストールすると、使わないコマンドでボットを埋め尽くすことになります。

Telegramエージェントのプラグインについてよくある質問#

体系的に作業するには、AIクローン + Second Brain + コンテキストエンジニアリングの組み合わせが役立ちます。

Ailootを開く。