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

> プラグインをどこにインストールするのか、スキルやMCPとどう違うのか、エージェントをどう再読み込みするのか、Telegramからコマンドをどう確認するのか。

Source: https://ailoot.ai/blog/ja/telegram-ai-agent-plugins/
Canonical: https://ailoot.ai/blog/ja/telegram-ai-agent-plugins/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-151
Revision: sha256-524058f4265616071b55ccddf1e1a49cce7a714387a66a743a115c4a44fdf8ab


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

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



[Ailootの活用に関する実用的な情報はドキュメントにあります](https://ailoot.ai/docs/)。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

プラグインとは、1つのコマンドでエージェントに追加できる、機能をまとめたセットです。スキル、個別のヘルパー、自動アクション、外部サービスへの接続が含まれています。プラグインをインストールすると、ボットには最初から備わっていなかった新しいコマンドが追加されます。プラグインを削除すると、それらの機能は消えます。スマートフォンにアプリをインストールするようなものですが、インストール先はAIエージェントです。

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

スキルは1つの機能、個別のヘルパーエージェントはより大きなサブタスクを担当し、外部サービスへの接続はボットに別のプログラムへのアクセスを与えます。プラグインは、これらすべてに説明ファイルを加えてまとめた箱です。1つの箱をインストールすれば、機能を1つずつ組み立てることなく、まとめて使えます。

</div>

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

| 何か | 何をするか | インストール方法 |
|----|----|----|
| スキル | 「私たちのスタイルでコミットを作成する」など、特定の機能を1つ実行する | エージェントのフォルダーに指示ファイルを置く |
| ヘルパーエージェント | コンテキストを消費せず、別の会話でより大きなサブタスクを担当する | 別のファイルに記述する |
| 自動アクション | 保存前や応答後など、イベントに応じて自動実行する | 設定にルールを追加する |
| サービス接続（MCP） | GitHub、データベース、ブラウザーなどの外部プログラムへのアクセスをボットに与える | アドレスとアクセスキーを設定する |
| プラグイン | これらすべてを組み合わせてパッケージ化した箱 | 1つのインストールコマンド |

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

プラグインをインストールするのは、Telegramではなく、Telegram経由であなたに応答するエージェントです。メッセンジャーはリモコンのようなもので、ボットに指示を送り、エージェントはコンピューターやサーバー上で動きます。つまり「Telegramにプラグインをインストールする」とは、「エージェントにプラグインをインストールし、チャットから引き続き操作する」という意味です。

</div>

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

まずプラグインのマーケットプレイスを接続し、次に目的のプラグインを名前でインストールして、最後にエージェントを再読み込みし、新しいプラグインを認識させます。Claude Codeでは、マーケットプレイスの追加、プラグインのインストール、プラグインの再読み込みという3つのコマンドで完了します。Hermes AgentとOpenClawも同じ流れですが、コマンド名は異なります。

</div>

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

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

```bash
/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つの柱です。



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

信頼性の異なる入手先は3つあります。Anthropic公式マーケットプレイス、審査済みのコミュニティマーケットプレイス、GitHub上のその他のサードパーティーディレクトリです。最初のマーケットプレイスはベンダー自身が運営しています。2つ目のプラグインは自動チェックに合格し、特定のバージョンに固定されています。3つ目は自己責任です。公式ソースから離れるほど、中身を慎重に確認する必要があります。

</div>

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

| 入手先 | 誰が責任を持つか | 接続方法 |
|----|----|----|
| 公式マーケットプレイス | Anthropicがディレクトリ自体を管理 | `/plugin marketplace add anthropics/claude-plugins-official` |
| コミュニティマーケットプレイス | サードパーティー製プラグインは自動チェックに合格し、各プラグインは特定のバージョンに固定されている | `/plugin marketplace add anthropics/claude-plugins-community` |
| ベンダーのサンプル | Anthropicがサンプルプラグインを提供 | `/plugin marketplace add anthropics/claude-code` |
| サードパーティーディレクトリ | GitHub上の作者が管理し、誰もチェックしていない | リポジトリのアドレスを使う。自己責任で行う |

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

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

<figure>
<blockquote>
<p>インストールする前に、プラグインを信頼できることを確認してください。Anthropicは、プラグインにどの接続、ファイル、その他のコードが含まれるかを管理しておらず、意図したとおりに動作することも保証できません。各プラグインのページを確認してください。</p>
</blockquote>
<figcaption>— Claude Code documentation, https://docs.claude.com/en/docs/claude-code/discover-plugins</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

エージェントにコマンド一覧を尋ねるか、プラグインパネルを開いてください。プラグインのコマンドが一覧にあれば接続されています。次に、チャットで小さなテストタスクを頼み、新しい機能を使ってボットが実行するか確認します。何も表示されない場合は、プラグインを再読み込みし忘れたか、別のマーケットプレイスを接続した可能性があります。

</div>

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

まず1つのコマンドでマーケットプレイスを更新します。そうして初めて、新しいプラグインのバージョンが利用可能になります。プラグインの削除もインストールと同じくらい簡単で、同じパネルを使います。実際に使うプラグインだけを接続しておきましょう。プラグインが増えるたびにボットのコマンドが増え、コンテキストも使われます。

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

まずはGitHub連携、コードレビュー、一貫したスタイルでのコミットという3つの分野から始めましょう。プロジェクトを作り、チャットからエージェントを管理する人なら、ほとんど誰にとっても必要です。そのほかは個別のタスクに応じて追加してください。プラグインを前もってインストールする必要はありません。使わないプラグインはボットの動作を遅くするだけです。

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

重要なポイント

よくある質問に簡潔に答えます。プラグインのほとんどは無料で、クラウド型とローカル型のどちらのボットでも使えます。また、ステッカーストアにある「Telegramプラグイン」は、AIエージェント拡張機能とは別物です。インストール前に危険な権限を確認でき、インストールを取り消すのも1分でできます。

</div>

<div class="section">

### よくある質問

エージェントのプラグインは有料ですか？

公式およびコミュニティマーケットプレイスのプラグインは無料です。オープンソースで、接続料金もかかりません。ただし、エージェントに接続しているモデルが有料の場合や、プラグインが外部サービスを使う場合は料金がかかることがあります。プラグインをインストールするだけなら料金はかかりません。

ボットがサーバー上で動いている場合もプラグインをインストールできますか？

はい。それが最も一般的なケースです。同じコマンドを使い、サーバーのターミナルにログインしてインストールするか、監督なしでインストールさせてもよいと判断した場合は、Telegramでエージェントにコマンドを伝えます。インストール後、ボットを再起動するか、プラグインを再読み込みするよう伝えてください。そうしないと、新しい機能を認識できません。

AIエージェント用プラグインはTelegram用プラグインとどう違いますか？

「プラグイン」という言葉が共通しているため混同されますが、別のものです。Telegram自体にボット拡張機能はありません。メッセンジャーはメッセージを中継するだけです。プラグインをインストールするのは、Telegram経由であなたに応答するAIエージェントで、エージェントはコンピューターやサーバー上で動きます。メッセンジャーの中にあるわけではありません。

プラグインが信頼できるかどうかは、どうすれば分かりますか？

入手先と権限一覧を確認してください。公式マーケットプレイスはベンダーが運営し、コミュニティプラグインは自動チェックに合格してバージョンが固定されています。インストール前に、エージェントはプラグインが何を追加するかを正確に表示します。メモ用の拡張機能がターミナルアクセスを求めているなら、注意してインストールを見送る理由になります。

インストール後にプラグインが動かない場合、どうすればよいですか？

ほとんどの場合、原因は2つのうちどちらかです。インストール後にプラグインを再読み込みしていないか、間違ったマーケットプレイスを接続したかです。エージェントにプラグインを再読み込みするよう伝え、それでも解決しなければボットを完全に再起動してください。普段使っているのと同じチャットで確認します。ターミナルではプラグインが見えていても、Telegramのボットがまだ認識していない可能性があります。

</div>

<div class="section" role="doc-bibliography" aria-label="Sources">

### 出典

- [Claude Code、プラグインの仕組み](https://docs.claude.com/en/docs/claude-code/plugins)
- [Claude Code、プラグインの検索とインストール](https://docs.claude.com/en/docs/claude-code/discover-plugins)
- [Claude Code、プラグインのマーケットプレイス](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces)
- [Claude Codeの公式プラグインディレクトリ](https://claude.com/plugins)
- [GitHub上のコミュニティプラグインマーケットプレイス](https://github.com/anthropics/claude-plugins-community)
- [Hermes Agent、ドキュメント](https://hermes-agent.nousresearch.com/docs/)
- [Hermes Agent、Telegramへの接続](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram)
- [OpenClaw、公式ウェブサイト](https://openclaw.ai/)
- ガイド：Claude Code用プラグイントップ10
- [ガイド：Claude Code用スキルの選び方](https://ailoot.ai/blog/ja/choose-claude-code-skills/)
- [ガイド：バイブコーディングのセキュリティ](https://ailoot.ai/blog/ja/vibe-coding-security/)

</div>

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





[Ailootを開く](https://ailoot.ai/)。

## AIエージェントTelegramボット用プラグイン：インストールと確認：よくある質問

### プラグインを入れたのにTelegramで動かない場合は？

実行中のエージェントがまだ読み込んでいない可能性があります。プラグインを再読み込みするかボットを再起動し、コマンドを確認して、同じTelegramチャットから無害なテストをしてください。導入完了の出力だけでは、現在のセッションに反映された証拠になりません。

### ボットがサーバーで動く場合、プラグインはどこへ入れますか？

ボットを動かすマシン上のエージェントに入れます。Telegramはメッセージと返答を中継するもので、拡張機能の保存先ではありません。そこで導入する前に、提供元と追加される内容を確認してください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。