Plugin cho bot Telegram của tác nhân AI: cài đặt và kiểm tra

Tác nhân của tôi chạy trên máy chủ, và tôi ra lệnh cho nó từ Telegram: tôi viết trong cuộc trò chuyện, nó đọc tệp, thực hiện tác vụ rồi gửi kết quả cho tôi. Đến một lúc nào đó, bạn sẽ chạm tới giới hạn: bot cơ bản làm được rất ít, còn bạn muốn nó rà soát mã, commit lên GitHub hoặc biên soạn bản tóm tắt theo lịch. Câu trả lời là plugin.

Mọi người tìm kiếm “cách cài plugin trong Telegram” chính là vì điều này. Họ không nói về cửa hàng hình dán. Họ muốn biết cách trang bị cho bot những khả năng mới. Dưới đây là hướng dẫn từng bước: plugin là gì, thực sự cài ở đâu, cách cài một plugin trong năm phút và cách tránh đưa mã độc vào tác nhân của bạn. Mô tả này dựa trên tài liệu chính thức.

Thông tin thực tế về cách sử dụng Ailoot có trong tài liệu hướng dẫn.

Plugin cho tác nhân AI là gì, nói đơn giản?#

Hãy cùng phân tích. Một tác nhân AI khi mới cài đặt có thể làm những việc cơ bản: đọc tệp, viết mã và trả lời câu hỏi. Plugin là một thư mục chứa các khả năng bổ sung mà tác nhân nạp vào và bắt đầu sử dụng. Tài liệu chính thức của Claude Code mô tả plugin đúng như vậy: plugin mở rộng tác nhân bằng các skill, tác nhân trợ giúp riêng biệt, hành động tự động và kết nối với dịch vụ bên ngoài.

Đây là một ví dụ đơn giản. Cài plugin làm việc với GitHub, tác nhân sẽ có lệnh tạo commit, mở pull request và xem lại lịch sử thay đổi. Cài plugin rà soát, tác nhân sẽ kiểm tra mã của bạn để tìm lỗi và lỗ hổng bảo mật theo danh sách kiểm tra đã định sẵn. Bạn không phải tự cấu hình bất kỳ thứ gì trong số này: tác giả plugin đã chuẩn bị mọi thứ, và bạn chỉ cần kết nối plugin.

Một điều quan trọng nữa: plugin không dạy tác nhân điều gì đó “mãi mãi”. Đây là một mô-đun có thể gỡ bỏ. Kết nối hôm nay, ngắt kết nối ngày mai, bot sẽ trở lại bộ khả năng có trước khi cài plugin. Vì vậy, plugin rất tiện để dùng thử: chọn một plugin, chạy thử với công việc thực tế, và nếu không phù hợp, hãy gỡ nó mà không để lại dấu vết.

Plugin khác gì so với skill, MCP và subagent?#

Các thuật ngữ liên quan đến tác nhân có thể gây nhầm lẫn, nên tôi đã tóm tắt sự khác biệt trong bảng. Bảng này cũng trả lời được một nửa số câu hỏi mà người mới thường có.

Trong thế giới Claude Code, kết nối với dịch vụ bên ngoài được gọi là MCP. Đây là một tiêu chuẩn cho phép tác nhân truy cập GitHub, cơ sở dữ liệu hoặc trình duyệt. Bốn hàng đầu trong bảng là những khối cấu thành riêng biệt.

Hãy nhìn hàng cuối. Plugin nằm cao hơn bốn thành phần kia một cấp. Nó tập hợp skill, tác nhân trợ giúp, hành động tự động và MCP trong cùng một chiếc hộp. Tác giả đã lắp ráp mọi thứ, thêm tệp mô tả rồi xuất bản. Chỉ với một lệnh, bạn có được một bộ hoàn chỉnh sẵn dùng thay vì tự lắp ráp bốn phần riêng biệt.

Từ đó có một quy tắc lựa chọn đơn giản. Nếu bạn cần một khả năng nhỏ cho công việc của mình, hãy tự viết skill; việc đó mất mười lăm phút. Nếu bạn cần một bộ có sẵn từ những người đã giải quyết vấn đề của bạn, hãy lấy plugin. Tôi có một hướng dẫn riêng về cách chọn skill cho Claude Code, bao gồm cả cách tránh làm tác nhân quá tải với những skill không cần thiết.

“Cài plugin trong Telegram” nghĩa là gì, và Telegram liên quan thế nào?#

Đây là chỗ thường xảy ra nhầm lẫn. Bản thân Telegram không có plugin: ứng dụng nhắn tin không lưu trữ các khả năng của bot. Nó chuyển tin nhắn của bạn đến tác nhân và hiển thị câu trả lời của tác nhân. Bộ não nằm ở nơi khác—trên máy tính xách tay của bạn hoặc trên máy chủ chạy một tác nhân như Hermes Agent, OpenClaw, hay Claude Code được kết nối với cuộc trò chuyện.

Có hai cách cài plugin và cả hai đều hiệu quả:

1. Ngay trong cuộc trò chuyện. Gửi cho tác nhân một yêu cầu bằng ngôn ngữ tự nhiên trên Telegram: “hãy tự cài plugin GitHub”. Tác nhân sẽ tự cài plugin trên máy của nó rồi trả lời rằng đã sẵn sàng. Cách này tiện khi máy chủ ở xa còn bạn đang dùng điện thoại.
2. Trong terminal. Đăng nhập vào máy nơi tác nhân chạy và cài plugin tại đó bằng một lệnh. Đây là cách đáng tin cậy hơn trong lần đầu: bạn có thể xem toàn bộ kết quả và không bỏ sót gì.

Chọn cách nào tùy thuộc vào việc bạn có tin bot tự cài tiện ích mở rộng mà không cần giám sát hay không. Tôi đã tự cài những plugin đầu tiên trong terminal để có thể thấy chính xác những gì đang được kết nối. Sau khi quen với quy trình, tôi bắt đầu tin tưởng để tác nhân tự cài plugin từ cuộc trò chuyện. Dưới đây, tôi sẽ hướng dẫn cả hai cách.

Cách cài plugin vào tác nhân trong năm phút#

Tôi sẽ hướng dẫn với Claude Code vì quy trình được mô tả nguyên văn trong tài liệu và dễ làm theo. Các lệnh giống nhau khi dùng trong terminal và khi gửi cho tác nhân qua Telegram.

1. Mở danh sách plugin. Lệnh /plugin mở một bảng ngay trong terminal, với một thẻ hiển thị tất cả tiện ích mở rộng có sẵn và một thư mục tại claude.com/plugins. Đây là cửa hàng để bạn xem qua trước khi cài.
2. Kết nối marketplace chính thức. Nhập /plugin marketplace add anthropics/claude-plugins-official. Marketplace là thư mục nơi tác nhân tải plugin xuống. Marketplace chính thức do Anthropic vận hành.
3. Cài plugin bạn cần. Dùng tên plugin theo sau là tên marketplace, ngăn cách bằng dấu at:

/plugin install github@claude-plugins-official

4. Tải lại plugin. Nếu sau khi cài, bot thông báo “Run /reload-plugins to activate.”, hãy chạy /reload-plugins. Cho đến khi tải lại, các lệnh mới sẽ không xuất hiện trong cuộc trò chuyện hiện tại. Nếu bạn nhận được cảnh báo rằng thao tác tải lại sẽ đọc lại cuộc trò chuyện, hãy chạy lại lệnh dưới dạng /reload-plugins --force.

Vậy là xong. Giờ tác nhân đã có các lệnh của plugin. Trong Claude Code, tên plugin được dùng làm tiền tố, chẳng hạn /commit-commands:commit, nên bạn có thể thấy ngay lệnh đó đến từ plugin.

Khi gửi lệnh cho bot qua Telegram thay vì dùng terminal, Claude Code cũng có một lệnh cài đặt độc lập không cần bảng tương tác: claude plugin install. Tài liệu lưu ý một chi tiết: lệnh này không nạp plugin vào một cuộc trò chuyện đang mở. Tác nhân sẽ nhận plugin vào lần khởi chạy tiếp theo hoặc sau khi chạy /reload-plugins. Nói cách khác, sau khi cài, bạn cần khởi động lại bot, nếu không các lệnh mới sẽ chưa xuất hiện.

Trong Hermes Agent, bật và tắt tiện ích mở rộng bằng lệnh hermes tools, còn skill nằm trong thư mục riêng. OpenClaw cũng hoạt động tương tự: kết nối một bộ rồi khởi động lại bot. Tên gọi khác nhau nhưng thứ tự giống nhau: kết nối nguồn, cài theo tên và khởi động lại tác nhân.

Plugin là một khối cấu thành của kỹ thuật ngữ cảnh: bạn quyết định những khả năng nào tác nhân luôn có sẵn trước yêu cầu đầu tiên.

Nên lấy plugin ở đâu và có thể tin cậy plugin nào?#

Plugin là mã của người khác và có cùng quyền với tác nhân của bạn: truy cập tệp, terminal và dịch vụ. Vì vậy, nguồn gốc quan trọng hơn một lời mô tả hay. Dưới đây là các nguồn, từ đáng tin cậy nhất đến đáng ngờ nhất.

Để cài từ marketplace cộng đồng, dùng lệnh tương tự nhưng với marketplace khác: /plugin install plugin-name@claude-community. Tài liệu nêu rõ rằng các plugin này đã qua kiểm tra bảo mật tự động và mỗi plugin được ghim vào một phiên bản mã cụ thể. Điều đó có nghĩa bạn sẽ nhận được đúng thứ đã được kiểm tra, không có những thay đổi về sau do tác giả đưa vào mà bạn không biết.

Trước khi cài đặt, Claude Code hiển thị mục “Will install”: danh sách các lệnh, tác nhân trợ giúp, skill, hành động tự động và kết nối mà plugin sẽ bổ sung. Hãy đọc danh sách đó. Đây là cơ hội để bạn phát hiện một tiện ích ghi chú vì lý do nào đó lại yêu cầu quyền truy cập terminal. Tài liệu chính thức nêu quy tắc rất rõ:

Nói đơn giản: marketplace chính thức và marketplace đã qua thẩm định giúp bạn yên tâm hơn; chỉ dùng một repository GitHub ngẫu nhiên sau khi đọc nội dung bên trong và hiểu vì sao nó cần các quyền đã yêu cầu. Niềm tin vào mã của bên thứ ba không chỉ liên quan đến việc cài plugin, và tôi đề cập đến vấn đề đó trong bài viết về bảo mật vibe-coding.

Cách kiểm tra plugin đã được cài và hoạt động trong Telegram chưa#

Dành một phút để kiểm tra: thấy trạng thái “đã cài đặt” chưa có nghĩa là bot đã thực sự nhận plugin. Hãy làm theo các bước sau:

1. Kiểm tra danh sách. Mở lại bảng /plugin hoặc yêu cầu tác nhân hiển thị các lệnh có sẵn. Các lệnh của plugin mới sẽ xuất hiện trong danh sách, với tên plugin làm tiền tố trong Claude Code.
2. Giao một tác vụ thử nghiệm. Chọn việc gì đó an toàn, không phải công việc đang chạy thật. Nếu đã cài plugin GitHub, hãy yêu cầu nó hiển thị các commit mới nhất. Nếu đã cài plugin rà soát, hãy đưa cho nó một tệp nhỏ. Hãy chú ý một điều: bot có đảm nhận công việc bằng khả năng mới đó không?
3. Kiểm tra từ chính cuộc trò chuyện bạn dùng để làm việc. Nếu bạn điều khiển tác nhân qua Telegram, hãy gửi lệnh thử nghiệm trong Telegram. Đôi khi plugin hiển thị trong terminal nhưng bot trong cuộc trò chuyện vẫn chưa tải lại plugin.

Lý do phổ biến nhất khiến plugin đã cài nhưng các lệnh không hoạt động là bạn đã bỏ qua bước tải lại. Lệnh cài đặt đã chạy thành công, nhưng tác nhân trong cuộc trò chuyện đang mở vẫn dùng bộ khả năng cũ. /reload-plugins có thể hữu ích; nếu không được, hãy khởi động lại bot hoàn toàn. Lý do thứ hai là cài từ marketplace khác: tên plugin trùng khớp nhưng thư mục không đúng, nên tác nhân báo chính xác rằng plugin không có trong các marketplace đã kết nối.

Nếu bot trả lời trong cuộc trò chuyện nhưng không hiểu lệnh mới, điều đó không có nghĩa tác nhân bị hỏng hay bạn làm sai. Gần như luôn là do một trong hai việc: plugin chưa được tải lại hoặc bạn đã kết nối nhầm marketplace. Cả hai đều chỉ mất một phút để khắc phục.

Cách cập nhật và gỡ plugin mà không làm tác nhân thêm rối#

Có một chi tiết về cập nhật mà không phải ai cũng để ý. Khi tác giả phát hành phiên bản mới của plugin, phiên bản đó không tự xuất hiện. Trước tiên, hãy cập nhật thư mục marketplace bằng /plugin marketplace update, rồi mới cài phiên bản mới. Cho đến khi cập nhật marketplace, tác nhân vẫn xem phiên bản tải lần trước là phiên bản hiện tại. Điều này là có chủ ý: thay đổi của người khác sẽ không được đưa vào sau đó mà bạn không biết.

Gỡ plugin qua chính bảng /plugin bạn đã dùng để cài: tìm plugin trong danh sách đã cài và gỡ nó. Plugin sẽ không để lại dấu vết trong tác nhân, và các lệnh sẽ biến mất ngay khi bạn tải lại. Chính vì vậy, không cần ngại thử plugin: cài một loạt, giữ lại hai cái hoạt động tốt, rồi gỡ phần còn lại.

Và hãy giữ mọi thứ gọn gàng. Mỗi plugin được kết nối đều thêm các lệnh mà tác nhân cần ghi nhớ, đồng thời dùng một phần cửa sổ ngữ cảnh để chứa mô tả của chúng. Năm plugin bạn không dùng sẽ làm bot chậm hơn và khiến nó bối rối một cách vô ích. Quy tắc rất đơn giản: nếu một plugin không hữu ích trong hai tuần, hãy gỡ nó. Bạn có thể cài lại bằng một lệnh.

Tôi sẽ cài plugin nào trước?#

Tôi sẽ không đưa ra danh sách 100 plugin hàng đầu—chủ đề này xứng đáng có một hướng dẫn riêng, và tôi đã có bài viết về 10 plugin Claude Code hàng đầu. Dưới đây là ba lĩnh vực tôi đề xuất cho người mới quản lý tác nhân qua Telegram.

1. Làm việc với GitHub. Plugin cung cấp cho tác nhân các lệnh tạo commit, nhánh và pull request. Viết cho bot trong cuộc trò chuyện: “lưu công việc và đẩy lên repository”, thế là nó thực hiện. Điều này xóa bỏ nỗi lo lớn nhất của những người làm vibe-coding chưa có kinh nghiệm: sợ mất mã.
2. Rà soát mã. Plugin có danh sách kiểm tra lỗi, lỗ hổng bảo mật và điểm yếu. Plugin này đặc biệt hữu ích khi dùng Telegram: gửi một đoạn mã trong cuộc trò chuyện và nhận kết quả rà soát mà không cần mở trình soạn thảo.
3. Tạo commit theo phong cách nhất quán. Plugin nhỏ giúp tác nhân định dạng commit theo một mẫu thống nhất. Việc này có vẻ nhỏ nhặt, nhưng sau một tháng, lịch sử dự án sẽ gọn gàng như của một nhóm làm việc, thay vì biến thành mớ hỗn độn.

Sau đó, hãy chọn plugin cho từng tác vụ cụ thể. Đang làm việc với cơ sở dữ liệu? Lấy plugin cơ sở dữ liệu. Đang biên soạn bản tóm tắt? Lấy plugin lập lịch. Quy tắc chung vẫn vậy: bắt đầu từ một tác vụ, rồi tìm plugin phù hợp. Cài plugin từ trước, “để phòng khi cần”, là cách chắc chắn khiến bot chìm ngập trong những lệnh bạn không bao giờ dùng.

Mọi người còn hỏi gì về plugin trong tác nhân Telegram?#

Truy cập Ailoot.