# AI 代理 Telegram 機器人外掛：安裝與檢查

> 外掛安裝的位置、它與技能和 MCP 的差異、如何重新載入代理，以及如何從 Telegram 檢查指令。

Source: https://ailoot.ai/blog/zh-hant-tw/telegram-ai-agent-plugins/
Canonical: https://ailoot.ai/blog/zh-hant-tw/telegram-ai-agent-plugins/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-151
Revision: sha256-367f5a9eb519da4ad388ec46e0784d212510f290f19733b6b91a0bb4013b8630


我的代理在伺服器上執行，我透過 Telegram 給它指令：我在聊天室輸入訊息，它讀取檔案、執行工作，然後把結果傳給我。到了某個時候，你會遇到瓶頸：基本的機器人能做的事很少，而你希望它能檢查程式碼、提交到 GitHub，或定期彙整摘要。答案就是外掛。

人們搜尋「如何在 Telegram 安裝外掛」，正是為了這件事。他們說的不是貼圖商店，而是想知道如何讓機器人具備新能力。以下會逐步說明：外掛是什麼、實際安裝在哪裡、如何在五分鐘內安裝，以及如何避免把惡意程式碼帶進代理。本文根據官方文件撰寫。



[關於如何使用 Ailoot 的實用資訊，請參閱文件](https://ailoot.ai/docs/)。

## AI 代理外掛是什麼？簡單來說

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

重點摘要

外掛是一組現成的能力，只要一個指令就能新增到代理中。它包含技能、個別輔助工具、自動化動作，以及連接外部服務的功能。安裝外掛後，機器人就會取得原本不具備的新指令。移除外掛，這些指令也會消失。這就像在手機上安裝應用程式，只不過安裝對象是你的 AI 代理。

</div>

我們來拆解說明。AI 代理一開始就能做基本的事：讀取檔案、撰寫程式碼，以及回答問題。外掛是一個裝有額外能力的資料夾，代理會載入並開始使用。Claude Code 官方文件對外掛的描述正是如此：透過技能、個別輔助代理、自動化動作，以及連接外部服務的功能來擴充代理。

舉個簡單的例子。安裝 GitHub 外掛後，代理就會取得建立提交、開啟提取要求，以及檢視變更紀錄的指令。安裝程式碼審查外掛後，代理會依照預先設定的檢查清單，檢查程式碼是否有錯誤和安全漏洞。你不必手動設定這些功能：外掛作者已經全部組合好，你只要連接即可。

還有一件重要的事：外掛不會讓代理「永遠」學會某項能力。它是可移除的模組。今天連接、明天中斷，機器人就會恢復成安裝外掛前的能力組合。因此外掛很適合拿來試用：挑一個，在實際工作中使用看看；如果不適合你，就能不留痕跡地移除。

## 外掛與技能、MCP 和子代理有什麼不同？

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

重點摘要

技能是一項能力，個別的輔助代理負責較大型的子任務，而外部服務連線則讓機器人能存取另一個程式。外掛是裝著所有這些項目的盒子，還附有說明檔。安裝一個盒子就能一次取得整組能力，不必逐一組裝。

</div>

代理相關的術語容易讓人混淆，所以我把差異整理成表格。這也能回答新手一半的疑問。

| 內容 | 用途 | 安裝方式 |
|----|----|----|
| 技能 | 一項特定能力，例如「按照我們的風格建立提交」 | 將指示檔放進代理的資料夾 |
| 輔助代理 | 在獨立對話中負責較大型的子任務，不會占用你的上下文 | 在個別檔案中描述 |
| 自動化動作 | 在特定事件發生時自動觸發，例如儲存前或回覆後 | 在設定中新增規則 |
| 服務連線（MCP） | 讓機器人能存取外部程式，例如 GitHub、資料庫、瀏覽器 | 設定位址和存取金鑰 |
| 外掛 | 把上述項目組合並打包在一起的盒子 | 一個安裝指令 |

在 Claude Code 的世界裡，外部服務連線稱為 MCP。這是一種標準，讓代理能連接 GitHub、資料庫或瀏覽器。表格的前四列是各自獨立的組件。

看看最下面一列。外掛比前四項高一個層級。它把技能、輔助代理、自動化動作和 MCP 放進同一個盒子。作者把所有東西組合起來、加入說明檔，然後發布。你只要一個指令就能取得完整套件，不必自己分別組裝四個部分。

選擇方式很簡單。如果你的工作只需要一項小能力，就自己寫技能，花十五分鐘即可。如果你需要的是已經有人解決過類似問題的現成套件，就取得外掛。我另外寫了一份[如何為 Claude Code 選擇技能](https://ailoot.ai/blog/zh-hant-tw/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/zh-hant-tw/hermes-agent-install-setup/)、[OpenClaw](https://ailoot.ai/blog/zh-hant-tw/openclaw-install-telegram/)，或連接聊天室的 Claude Code。

安裝外掛有兩種方式，兩種都行得通：

1.  **直接從聊天室安裝。** 在 Telegram 中用一般語言向代理提出要求：「幫你自己安裝 GitHub 外掛。」代理會在自己的機器上安裝，並回覆你已準備就緒。如果伺服器離你很遠，而你正在使用手機，這種方式很方便。
2.  **在終端機安裝。** 登入代理執行所在的機器，然後在那裡用指令安裝外掛。第一次安裝時，這種方式更可靠：你可以看到所有輸出，不會漏掉任何內容。

該選哪種方式，取決於你是否信任機器人自行安裝擴充功能而不受監督。我第一次安裝外掛時，是在終端機手動操作，這樣就能確切看到連接了什麼。熟悉之後，我開始信任代理直接從聊天室自行安裝。以下會介紹這兩種方式。

## 如何在五分鐘內為代理安裝外掛？

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

重點摘要

先連接外掛市集，再按名稱安裝想要的外掛，接著重新載入代理，讓它載入新外掛。在 Claude Code 中只需要三個指令：新增市集、安裝外掛，以及重新載入外掛。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`。文件特別提醒一件事：這個指令不會將外掛載入已開啟的對話。代理會在下次啟動或執行 `/reload-plugins` 後載入外掛。換句話說，安裝後你需要重新啟動機器人，否則就無法使用新指令。

在 Hermes Agent 中，可以用 `hermes tools` 指令啟用或停用擴充功能，技能則放在自己的資料夾中。OpenClaw 也類似：連接一組功能，然後重新啟動機器人。名稱不同，但順序相同：連接來源、按名稱安裝，然後重新啟動代理。

外掛是上下文工程的一項組件：在第一次提出要求前，你可以決定讓代理隨時具備哪些能力。若要有系統地工作，可以規劃要放入技能和外掛中的專業知識、組織專案知識，並決定何時提供哪些資訊給代理。



## 外掛該從哪裡取得？哪些可以信任？

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

重點摘要

外掛來源有三種，可靠程度各不相同：Anthropic 官方市集、經過審核的社群市集，以及 GitHub 上的任何第三方目錄。第一個由供應商自行經營；第二個市集中的外掛通過了自動檢查，並固定在特定版本；第三種則由你自行承擔風險。來源離官方越遠，就越需要仔細檢查內容。

</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/zh-hant-tw/vibe-coding-security/)的文章中談到這個問題。

## 如何確認外掛已安裝，並且能在 Telegram 中正常運作？

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

重點摘要

請代理列出可用指令，或開啟外掛面板。如果清單中有外掛的指令，就表示它已連接。接著直接在聊天室中交辦一個小型測試任務，看看機器人是否運用新能力來執行。如果清單中沒有任何內容，可能是忘了重新載入外掛，或是連接了錯誤的市集。

</div>

花一分鐘檢查一下：「已安裝」不代表機器人真的載入了外掛。請依照以下步驟操作：

1.  **檢查清單。** 再次開啟 `/plugin` 面板，或請代理顯示可用指令。新外掛的指令應該會出現在清單中；在 Claude Code 中，指令前面會有外掛名稱作為前綴。
2.  **交辦測試任務。** 選一件安全的事，不要使用正式工作。如果安裝的是 GitHub 外掛，就請它顯示最近的提交；如果安裝的是程式碼審查外掛，就給它一個小型檔案。只要確認一件事：機器人是否運用新能力接手這項任務？
3.  **在平常工作的同一個聊天室中檢查。** 如果你透過 Telegram 操作代理，就在 Telegram 中傳送測試指令。有時外掛在終端機中看得到，但聊天室中的機器人還沒有重新載入。

外掛已安裝但指令無法使用，最常見的原因是你略過了重新載入。安裝指令已成功執行，但開啟的對話中的代理仍在使用舊的能力組合。執行 `/reload-plugins` 通常就能解決；如果無效，請完整重新啟動機器人。第二個原因是從不同的市集安裝：外掛名稱相同，但目錄不對，因此代理會正確指出，已連接的市集中找不到該外掛。

如果機器人在聊天室中有回覆，卻不理解新指令，並不表示代理壞了，也不代表你做錯了。幾乎總是以下兩種情況之一：外掛尚未重新載入，或連接了錯誤的市集。兩者都能在一分鐘內修好。

## 如何更新和移除外掛，避免代理變得雜亂？

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

重點摘要

用一個指令更新市集，之後才能取得新版外掛。移除外掛和安裝一樣簡單：使用同一個面板即可。只保留實際會用到的外掛。每多一個外掛，機器人就會多出一些指令，並占用更多上下文。

</div>

更新有個不太明顯的細節。作者發布外掛的新版本後，它不會自動出現。你必須先用 `/plugin marketplace update` 更新市集目錄，再安裝新版。在更新市集之前，代理會把上次下載的版本視為最新版本。這是刻意設計的：其他人的變更不會在你不知情的情況下悄悄加入。

要移除外掛，請使用安裝時用過的同一個 `/plugin` 面板：在已安裝清單中找到外掛並將它移除。代理中不會留下任何痕跡，重新載入後，相關指令就會消失。這正是外掛很適合拿來嘗試的原因：一次安裝幾個，留下兩個好用的，其他的就移除。

也要保持整潔。每個已連接的外掛都會增加代理必須記住的指令，也會占用部分上下文視窗來存放說明。五個用不到的外掛會拖慢機器人，還會造成不必要的混淆。規則很簡單：如果某個外掛兩週都沒派上用場，就移除它。只要一個指令就能重新安裝。

## 我會先安裝哪些外掛？

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

重點摘要

先從三個領域開始：GitHub 操作、程式碼審查，以及維持一致風格的提交。幾乎所有開發專案、並從聊天室管理代理的人都需要這些能力。其他功能則依特定工作再新增。沒有必要預先安裝外掛：不用的外掛只會拖慢機器人。

</div>

我不會列出前 100 名清單——這值得另外寫一份指南，而且我已經有一篇Claude Code 外掛 Top 10的文章。以下是我推薦給從 Telegram 管理代理的新手的三個領域。

1.  **操作 GitHub。** 這種外掛會為代理新增建立提交、分支和提取要求的指令。在聊天室中對機器人說：「儲存工作並推送到儲存庫」，它就會替你完成。對沒有經驗、透過氛圍式編碼的人來說，這能消除最主要的擔憂：害怕遺失程式碼。
2.  **程式碼審查。** 這種外掛包含檢查錯誤、安全漏洞和弱點的清單。搭配 Telegram 特別實用：在聊天室中傳送一段程式碼，就能取得審查結果，不必開啟編輯器。
3.  **維持一致風格的提交。** 這是一個小型外掛，會讓代理按照同一個範本格式化提交。這似乎不重要，但一個月後，專案紀錄會像團隊協作的成果一樣整齊，而不是變得雜亂無章。

之後，再依特定工作選擇外掛。要操作資料庫？取得資料庫外掛。要彙整摘要？取得排程外掛。通則一樣：先有工作需求，再找對應的外掛。提前安裝外掛「以備不時之需」，只會讓機器人被你永遠用不到的指令淹沒。

## 大家還會問 Telegram 代理外掛的哪些問題？

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

重點摘要

常見問題快速解答：外掛大多免費，雲端機器人和本機機器人都能使用；貼圖商店裡的「Telegram 外掛」則是另一回事，和 AI 代理擴充功能不同。安裝前可以查看有風險的權限，而且一分鐘內就能復原安裝。

</div>

<div class="section">

### 常見問題

代理外掛要付費嗎？

官方和社群市集中的外掛都是免費的：它們是開放原始碼，連接時不會收費。如果代理連接的模型需要付費，或外掛會使用外部服務，可能就會產生費用。但你不會只因為安裝外掛而付費。

如果機器人在伺服器上執行，我也能安裝外掛嗎？

可以，而且這是最常見的情況。使用相同的指令安裝即可：登入伺服器的終端機操作，或是如果你信任代理在沒有監督的情況下自行安裝，就直接在 Telegram 中把指令交給代理。安裝後，你需要重新啟動機器人，或告訴它重新載入外掛，否則它不會載入新能力。

AI 代理外掛和 Telegram 外掛有什麼不同？

兩者是不同的東西，只是因為都用了「外掛」這個詞而容易混淆。Telegram 本身沒有機器人擴充功能：通訊軟體只負責傳遞訊息。外掛安裝在透過 Telegram 回覆你的 AI 代理中，而代理在電腦或伺服器上執行。它不在通訊軟體裡。

如何判斷外掛是否可信？

檢查來源和權限清單。官方市集由供應商經營，社群外掛則通過自動檢查，並固定在特定版本。安裝前，代理會明確顯示外掛將新增的內容：如果筆記擴充功能要求終端機存取權，就要提高警覺，不要安裝。

如果外掛安裝後無法運作，該怎麼辦？

幾乎總是以下兩種原因之一：安裝後沒有重新載入外掛，或是連接了錯誤的市集。請代理重新載入外掛；如果仍然無效，就完整重新啟動機器人。請在平常工作的同一個聊天室中檢查：外掛在終端機中可能看得到，但 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 外掛 Top 10
- [指南：如何為 Claude Code 選擇技能](https://ailoot.ai/blog/zh-hant-tw/choose-claude-code-skills/)
- [指南：氛圍式編碼安全](https://ailoot.ai/blog/zh-hant-tw/vibe-coding-security/)

</div>

若要有系統地工作，可以規劃要放入技能和外掛中的專業知識、組織專案知識，並決定何時提供哪些資訊給代理。





[前往 Ailoot](https://ailoot.ai/)。

## 常見問題：AI 代理 Telegram 機器人外掛：安裝與檢查

### 外掛已安裝，為什麼 Telegram 還不能用？

執行中的代理可能尚未載入。重載外掛或重啟 bot，再在同一 Telegram 對話查看指令、跑無害測試；安裝輸出不代表目前工作階段已載入。

### bot 在伺服器執行時，外掛應裝哪裡？

裝在執行 bot 的機器上、該代理內。Telegram 只轉送訊息和顯示回覆，不保存代理擴充。安裝前先查來源及將新增的內容。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。