AI 代理 Telegram 機器人外掛：安裝與檢查
Markdown外掛安裝的位置、它與技能和 MCP 的差異、如何重新載入代理，以及如何從 Telegram 檢查指令。
閱讀全文
我的代理在伺服器上執行，我透過 Telegram 給它指令：我在聊天室輸入訊息，它讀取檔案、執行工作，然後把結果傳給我。到了某個時候，你會遇到瓶頸：基本的機器人能做的事很少，而你希望它能檢查程式碼、提交到 GitHub，或定期彙整摘要。答案就是外掛。
人們搜尋「如何在 Telegram 安裝外掛」，正是為了這件事。他們說的不是貼圖商店，而是想知道如何讓機器人具備新能力。以下會逐步說明：外掛是什麼、實際安裝在哪裡、如何在五分鐘內安裝，以及如何避免把惡意程式碼帶進代理。本文根據官方文件撰寫。
AI 代理外掛是什麼？簡單來說
重點摘要
外掛是一組現成的能力，只要一個指令就能新增到代理中。它包含技能、個別輔助工具、自動化動作，以及連接外部服務的功能。安裝外掛後，機器人就會取得原本不具備的新指令。移除外掛，這些指令也會消失。這就像在手機上安裝應用程式，只不過安裝對象是你的 AI 代理。
我們來拆解說明。AI 代理一開始就能做基本的事：讀取檔案、撰寫程式碼，以及回答問題。外掛是一個裝有額外能力的資料夾，代理會載入並開始使用。Claude Code 官方文件對外掛的描述正是如此：透過技能、個別輔助代理、自動化動作，以及連接外部服務的功能來擴充代理。
舉個簡單的例子。安裝 GitHub 外掛後，代理就會取得建立提交、開啟提取要求，以及檢視變更紀錄的指令。安裝程式碼審查外掛後，代理會依照預先設定的檢查清單，檢查程式碼是否有錯誤和安全漏洞。你不必手動設定這些功能：外掛作者已經全部組合好，你只要連接即可。
還有一件重要的事：外掛不會讓代理「永遠」學會某項能力。它是可移除的模組。今天連接、明天中斷，機器人就會恢復成安裝外掛前的能力組合。因此外掛很適合拿來試用：挑一個，在實際工作中使用看看；如果不適合你，就能不留痕跡地移除。
外掛與技能、MCP 和子代理有什麼不同？
重點摘要
技能是一項能力，個別的輔助代理負責較大型的子任務，而外部服務連線則讓機器人能存取另一個程式。外掛是裝著所有這些項目的盒子，還附有說明檔。安裝一個盒子就能一次取得整組能力，不必逐一組裝。
代理相關的術語容易讓人混淆，所以我把差異整理成表格。這也能回答新手一半的疑問。
| 內容 | 用途 | 安裝方式 |
|---|---|---|
| 技能 | 一項特定能力，例如「按照我們的風格建立提交」 | 將指示檔放進代理的資料夾 |
| 輔助代理 | 在獨立對話中負責較大型的子任務，不會占用你的上下文 | 在個別檔案中描述 |
| 自動化動作 | 在特定事件發生時自動觸發，例如儲存前或回覆後 | 在設定中新增規則 |
| 服務連線（MCP） | 讓機器人能存取外部程式，例如 GitHub、資料庫、瀏覽器 | 設定位址和存取金鑰 |
| 外掛 | 把上述項目組合並打包在一起的盒子 | 一個安裝指令 |
在 Claude Code 的世界裡，外部服務連線稱為 MCP。這是一種標準，讓代理能連接 GitHub、資料庫或瀏覽器。表格的前四列是各自獨立的組件。
看看最下面一列。外掛比前四項高一個層級。它把技能、輔助代理、自動化動作和 MCP 放進同一個盒子。作者把所有東西組合起來、加入說明檔，然後發布。你只要一個指令就能取得完整套件，不必自己分別組裝四個部分。
選擇方式很簡單。如果你的工作只需要一項小能力，就自己寫技能，花十五分鐘即可。如果你需要的是已經有人解決過類似問題的現成套件，就取得外掛。我另外寫了一份如何為 Claude Code 選擇技能的指南，也說明如何避免讓代理塞進太多不必要的技能。
「在 Telegram 安裝外掛」是什麼意思？Telegram 又有什麼關係？
重點摘要
外掛安裝在透過 Telegram 回覆你的代理中，而不是安裝在 Telegram 裡。通訊軟體本身就像遙控器：你用它向機器人下指令，代理則在電腦或伺服器上執行。因此，「在 Telegram 安裝外掛」真正的意思是「在代理中安裝外掛，並繼續透過聊天室操作它」。
常見的混淆就在這裡。Telegram 本身沒有外掛：通訊軟體不會儲存機器人的能力。它會把你的訊息傳給代理，再顯示代理的回覆。真正的核心在別處——可能在你的筆電上，也可能在執行代理的伺服器上，例如 Hermes Agent、OpenClaw，或連接聊天室的 Claude Code。
安裝外掛有兩種方式，兩種都行得通：
- 直接從聊天室安裝。 在 Telegram 中用一般語言向代理提出要求：「幫你自己安裝 GitHub 外掛。」代理會在自己的機器上安裝，並回覆你已準備就緒。如果伺服器離你很遠，而你正在使用手機，這種方式很方便。
- 在終端機安裝。 登入代理執行所在的機器，然後在那裡用指令安裝外掛。第一次安裝時，這種方式更可靠：你可以看到所有輸出，不會漏掉任何內容。
該選哪種方式，取決於你是否信任機器人自行安裝擴充功能而不受監督。我第一次安裝外掛時，是在終端機手動操作，這樣就能確切看到連接了什麼。熟悉之後，我開始信任代理直接從聊天室自行安裝。以下會介紹這兩種方式。
如何在五分鐘內為代理安裝外掛？
重點摘要
先連接外掛市集，再按名稱安裝想要的外掛，接著重新載入代理，讓它載入新外掛。在 Claude Code 中只需要三個指令：新增市集、安裝外掛，以及重新載入外掛。Hermes Agent 和 OpenClaw 的邏輯相同，只是指令名稱不同。
我會以 Claude Code 為例，因為它的文件逐字說明了這個流程，而且很容易照著操作。在終端機輸入指令，或透過 Telegram 傳給代理，使用的指令都相同。
- 開啟外掛清單。
/plugin指令會直接在終端機中開啟一個面板，其中有顯示所有可用擴充功能的分頁，並提供 claude.com/plugins 目錄。這是一個可以先瀏覽再安裝的商店。 - 連接官方市集。 輸入
/plugin marketplace add anthropics/claude-plugins-official。市集是代理下載外掛的目錄。官方市集由 Anthropic 經營。 - 安裝需要的外掛。 先輸入外掛名稱，再輸入市集名稱，中間以 @ 符號分隔：
/plugin install github@claude-plugins-official
- 重新載入外掛。 如果安裝後機器人顯示「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 也類似：連接一組功能，然後重新啟動機器人。名稱不同，但順序相同：連接來源、按名稱安裝，然後重新啟動代理。
外掛是上下文工程的一項組件：在第一次提出要求前，你可以決定讓代理隨時具備哪些能力。若要有系統地工作，可以規劃要放入技能和外掛中的專業知識、組織專案知識，並決定何時提供哪些資訊給代理。
外掛該從哪裡取得？哪些可以信任？
重點摘要
外掛來源有三種，可靠程度各不相同：Anthropic 官方市集、經過審核的社群市集，以及 GitHub 上的任何第三方目錄。第一個由供應商自行經營；第二個市集中的外掛通過了自動檢查，並固定在特定版本；第三種則由你自行承擔風險。來源離官方越遠，就越需要仔細檢查內容。
外掛是別人寫的程式碼，它取得的權限和你的代理相同：存取檔案、終端機和服務。因此，來源比好看的說明更重要。以下依照可靠程度排序。
| 來源 | 責任方 | 連接方式 |
|---|---|---|
| 官方市集 | 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」區段，列出外掛將新增的指令、輔助工具、技能、自動化動作和連線。請仔細閱讀。這是你發現某個筆記擴充功能不知為何要求終端機存取權的機會。官方文件明確說明了這項原則：
安裝前請確認你信任該外掛。Anthropic 不會控制外掛包含哪些連線、檔案或其他程式碼，也無法保證外掛會如預期運作。請查看每個外掛的頁面。
簡單來說，官方和經審核的市集能讓你比較安心；只有在讀過 GitHub 上隨機找到的儲存庫內容，並理解它為何需要所要求的權限後，才使用它。信任第三方程式碼不只關乎安裝外掛，我也在氛圍式編碼安全的文章中談到這個問題。
如何確認外掛已安裝，並且能在 Telegram 中正常運作？
重點摘要
請代理列出可用指令，或開啟外掛面板。如果清單中有外掛的指令，就表示它已連接。接著直接在聊天室中交辦一個小型測試任務，看看機器人是否運用新能力來執行。如果清單中沒有任何內容，可能是忘了重新載入外掛，或是連接了錯誤的市集。
花一分鐘檢查一下：「已安裝」不代表機器人真的載入了外掛。請依照以下步驟操作：
- 檢查清單。 再次開啟
/plugin面板，或請代理顯示可用指令。新外掛的指令應該會出現在清單中；在 Claude Code 中，指令前面會有外掛名稱作為前綴。 - 交辦測試任務。 選一件安全的事，不要使用正式工作。如果安裝的是 GitHub 外掛，就請它顯示最近的提交；如果安裝的是程式碼審查外掛，就給它一個小型檔案。只要確認一件事：機器人是否運用新能力接手這項任務？
- 在平常工作的同一個聊天室中檢查。 如果你透過 Telegram 操作代理，就在 Telegram 中傳送測試指令。有時外掛在終端機中看得到，但聊天室中的機器人還沒有重新載入。
外掛已安裝但指令無法使用，最常見的原因是你略過了重新載入。安裝指令已成功執行，但開啟的對話中的代理仍在使用舊的能力組合。執行 /reload-plugins 通常就能解決；如果無效，請完整重新啟動機器人。第二個原因是從不同的市集安裝：外掛名稱相同，但目錄不對，因此代理會正確指出，已連接的市集中找不到該外掛。
如果機器人在聊天室中有回覆，卻不理解新指令，並不表示代理壞了，也不代表你做錯了。幾乎總是以下兩種情況之一：外掛尚未重新載入，或連接了錯誤的市集。兩者都能在一分鐘內修好。
如何更新和移除外掛，避免代理變得雜亂？
重點摘要
用一個指令更新市集，之後才能取得新版外掛。移除外掛和安裝一樣簡單：使用同一個面板即可。只保留實際會用到的外掛。每多一個外掛，機器人就會多出一些指令，並占用更多上下文。
更新有個不太明顯的細節。作者發布外掛的新版本後，它不會自動出現。你必須先用 /plugin marketplace update 更新市集目錄，再安裝新版。在更新市集之前，代理會把上次下載的版本視為最新版本。這是刻意設計的：其他人的變更不會在你不知情的情況下悄悄加入。
要移除外掛，請使用安裝時用過的同一個 /plugin 面板：在已安裝清單中找到外掛並將它移除。代理中不會留下任何痕跡，重新載入後，相關指令就會消失。這正是外掛很適合拿來嘗試的原因：一次安裝幾個，留下兩個好用的，其他的就移除。
也要保持整潔。每個已連接的外掛都會增加代理必須記住的指令，也會占用部分上下文視窗來存放說明。五個用不到的外掛會拖慢機器人，還會造成不必要的混淆。規則很簡單：如果某個外掛兩週都沒派上用場，就移除它。只要一個指令就能重新安裝。
我會先安裝哪些外掛？
重點摘要
先從三個領域開始：GitHub 操作、程式碼審查，以及維持一致風格的提交。幾乎所有開發專案、並從聊天室管理代理的人都需要這些能力。其他功能則依特定工作再新增。沒有必要預先安裝外掛：不用的外掛只會拖慢機器人。
我不會列出前 100 名清單——這值得另外寫一份指南，而且我已經有一篇Claude Code 外掛 Top 10的文章。以下是我推薦給從 Telegram 管理代理的新手的三個領域。
- 操作 GitHub。 這種外掛會為代理新增建立提交、分支和提取要求的指令。在聊天室中對機器人說：「儲存工作並推送到儲存庫」，它就會替你完成。對沒有經驗、透過氛圍式編碼的人來說，這能消除最主要的擔憂：害怕遺失程式碼。
- 程式碼審查。 這種外掛包含檢查錯誤、安全漏洞和弱點的清單。搭配 Telegram 特別實用：在聊天室中傳送一段程式碼，就能取得審查結果，不必開啟編輯器。
- 維持一致風格的提交。 這是一個小型外掛，會讓代理按照同一個範本格式化提交。這似乎不重要，但一個月後，專案紀錄會像團隊協作的成果一樣整齊，而不是變得雜亂無章。
之後，再依特定工作選擇外掛。要操作資料庫？取得資料庫外掛。要彙整摘要？取得排程外掛。通則一樣：先有工作需求，再找對應的外掛。提前安裝外掛「以備不時之需」，只會讓機器人被你永遠用不到的指令淹沒。
大家還會問 Telegram 代理外掛的哪些問題？
重點摘要
常見問題快速解答：外掛大多免費，雲端機器人和本機機器人都能使用；貼圖商店裡的「Telegram 外掛」則是另一回事，和 AI 代理擴充功能不同。安裝前可以查看有風險的權限，而且一分鐘內就能復原安裝。
常見問題
代理外掛要付費嗎？
官方和社群市集中的外掛都是免費的：它們是開放原始碼，連接時不會收費。如果代理連接的模型需要付費，或外掛會使用外部服務，可能就會產生費用。但你不會只因為安裝外掛而付費。
如果機器人在伺服器上執行，我也能安裝外掛嗎？
可以，而且這是最常見的情況。使用相同的指令安裝即可：登入伺服器的終端機操作，或是如果你信任代理在沒有監督的情況下自行安裝，就直接在 Telegram 中把指令交給代理。安裝後，你需要重新啟動機器人，或告訴它重新載入外掛，否則它不會載入新能力。
AI 代理外掛和 Telegram 外掛有什麼不同？
兩者是不同的東西，只是因為都用了「外掛」這個詞而容易混淆。Telegram 本身沒有機器人擴充功能：通訊軟體只負責傳遞訊息。外掛安裝在透過 Telegram 回覆你的 AI 代理中，而代理在電腦或伺服器上執行。它不在通訊軟體裡。
如何判斷外掛是否可信？
檢查來源和權限清單。官方市集由供應商經營，社群外掛則通過自動檢查，並固定在特定版本。安裝前，代理會明確顯示外掛將新增的內容：如果筆記擴充功能要求終端機存取權，就要提高警覺，不要安裝。
如果外掛安裝後無法運作，該怎麼辦？
幾乎總是以下兩種原因之一：安裝後沒有重新載入外掛，或是連接了錯誤的市集。請代理重新載入外掛；如果仍然無效，就完整重新啟動機器人。請在平常工作的同一個聊天室中檢查：外掛在終端機中可能看得到，但 Telegram 中的機器人尚未載入。
來源
若要有系統地工作，可以規劃要放入技能和外掛中的專業知識、組織專案知識，並決定何時提供哪些資訊給代理。
更多詳情
常見問題：AI 代理 Telegram 機器人外掛：安裝與檢查
外掛已安裝，為什麼 Telegram 還不能用？
執行中的代理可能尚未載入。重載外掛或重啟 bot，再在同一 Telegram 對話查看指令、跑無害測試；安裝輸出不代表目前工作階段已載入。
bot 在伺服器執行時，外掛應裝哪裡？
裝在執行 bot 的機器上、該代理內。Telegram 只轉送訊息和顯示回覆，不保存代理擴充。安裝前先查來源及將新增的內容。