# AI 에이전트 Telegram 봇용 플러그인: 설치 및 확인

> 플러그인이 설치되는 위치, 스킬 및 MCP와의 차이, 에이전트 재로드 방법, Telegram에서 명령을 확인하는 방법을 설명합니다.

Source: https://ailoot.ai/blog/ko/telegram-ai-agent-plugins/
Canonical: https://ailoot.ai/blog/ko/telegram-ai-agent-plugins/
Language: ko
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-151
Revision: sha256-66cf041ee22ea3b9deede99b9dfe804dcc60329b33167643346134a3582d5880


제 에이전트는 서버에서 실행되고, 저는 Telegram에서 명령을 내립니다. 채팅에 글을 쓰면 에이전트가 파일을 읽고 작업을 실행한 뒤 결과를 보내 줍니다. 어느 순간 한계에 부딪힙니다. 기본 봇으로는 할 수 있는 일이 거의 없고, 코드를 검토하거나 GitHub에 커밋하거나 예약된 요약을 작성하게 하고 싶어집니다. 해결책은 플러그인입니다.

사람들이 “Telegram에 플러그인 설치하는 방법”을 검색하는 이유가 바로 이것입니다. 스티커 스토어를 말하는 게 아닙니다. 봇에 새로운 기능을 추가하는 방법을 알고 싶은 것입니다. 아래에서 플러그인이 무엇인지, 실제로 어디에 설치되는지, 5분 만에 설치하는 방법, 에이전트에 악성 코드를 들이지 않는 방법을 단계별로 설명합니다. 이 설명은 공식 문서를 바탕으로 합니다.



[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 작업용 플러그인을 설치하면 에이전트에 커밋 생성, pull request 열기, 변경 이력 검토 명령이 추가됩니다. 코드 검토 플러그인을 설치하면 미리 정해진 체크리스트에 따라 코드의 오류와 보안 취약점을 확인합니다. 이 모든 것을 직접 설정할 필요는 없습니다. 플러그인 작성자가 미리 구성해 두었고, 사용자는 연결하기만 하면 됩니다.

한 가지 더 중요한 점이 있습니다. 플러그인은 에이전트에 무언가를 “영원히” 가르치는 것이 아닙니다. 제거할 수 있는 모듈입니다. 오늘 연결했다가 내일 연결을 해제하면 봇은 플러그인을 설치하기 전의 기능으로 돌아갑니다. 그래서 플러그인을 부담 없이 시험해 볼 수 있습니다. 하나를 골라 실제 작업에 사용해 보고, 마음에 들지 않으면 흔적 없이 제거하면 됩니다.

## 플러그인은 스킬, MCP, 서브에이전트와 어떻게 다른가요?

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

핵심 요점

스킬은 하나의 기능이고, 별도의 헬퍼 에이전트는 더 큰 하위 작업을 맡으며, 외부 서비스 연결은 봇에 다른 프로그램에 대한 접근 권한을 제공합니다. 플러그인은 설명 파일과 함께 이런 요소를 모두 담은 상자입니다. 요소를 하나씩 조립하는 대신 상자 하나를 설치해 여러 기능을 한꺼번에 얻을 수 있습니다.

</div>

에이전트와 관련된 용어는 헷갈릴 수 있어서 차이를 표로 정리했습니다. 초보자가 궁금해하는 내용의 절반은 이 표로 설명할 수 있습니다.

| 무엇인가요 | 어떤 일을 하나요 | 어떻게 설치하나요 |
|----|----|----|
| 스킬 | “우리 방식대로 커밋 만들기” 같은 특정 기능 하나 | 에이전트 폴더에 지침 파일을 넣습니다 |
| 헬퍼 에이전트 | 사용자의 컨텍스트를 소모하지 않고 별도 대화에서 더 큰 하위 작업을 맡습니다 | 별도의 파일에 설명합니다 |
| 자동화된 작업 | 저장 전이나 응답 후처럼 이벤트가 발생하면 자동으로 실행됩니다 | 설정에 규칙을 추가합니다 |
| 서비스 연결(MCP) | 봇에 GitHub, 데이터베이스, 브라우저 같은 외부 프로그램에 대한 접근 권한을 제공합니다 | 주소와 액세스 키를 설정합니다 |
| 플러그인 | 이 모든 요소를 조립하고 패키징해 담은 상자입니다 | 설치 명령 하나를 사용합니다 |

Claude Code에서는 외부 서비스 연결을 MCP라고 부릅니다. 에이전트가 GitHub, 데이터베이스, 브라우저에 접근하도록 해 주는 표준입니다. 표의 처음 네 항목은 각각 독립된 구성 요소입니다.

마지막 행을 보세요. 플러그인은 나머지 네 요소보다 한 단계 위에 있습니다. 스킬, 헬퍼, 자동화된 작업, MCP를 상자 하나에 담아 제공합니다. 작성자가 모든 요소를 조립하고 설명 파일을 추가한 뒤 공개합니다. 네 가지 구성 요소를 따로 조립하는 대신 명령 하나로 완성된 묶음을 얻을 수 있습니다.

선택할 때는 다음과 같은 간단한 기준을 따르면 됩니다. 작업에 필요한 기능이 하나뿐이라면 스킬을 직접 작성하세요. 15분이면 됩니다. 이미 같은 문제를 해결한 사람들이 만든 완성된 묶음이 필요하다면 플러그인을 고르세요. [Claude Code 스킬 선택 방법](https://ailoot.ai/blog/ko/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/ko/hermes-agent-install-setup/), [OpenClaw](https://ailoot.ai/blog/ko/openclaw-install-telegram/) 같은 에이전트 또는 채팅에 연결된 Claude Code가 실행되는 서버입니다.

플러그인을 설치하는 방법은 두 가지이며, 둘 다 사용할 수 있습니다.

1.  **채팅에서 바로 설치합니다.** Telegram에서 에이전트에 “GitHub 플러그인을 너 자신에게 설치해”라고 자연어로 요청합니다. 에이전트는 자기 컴퓨터에 플러그인을 설치하고 준비됐다고 답합니다. 서버가 멀리 있고 사용자가 휴대폰을 사용 중일 때 편리합니다.
2.  **터미널에서 설치합니다.** 에이전트가 실행되는 컴퓨터에 로그인한 뒤 명령으로 플러그인을 설치합니다. 처음에는 이 방법이 더 확실합니다. 모든 출력 내용을 직접 확인할 수 있고 놓치는 부분이 없기 때문입니다.

어떤 방법을 선택할지는 감독 없이 봇이 알아서 확장 기능을 설치하도록 믿을 수 있는지에 달려 있습니다. 저는 처음에는 무엇이 연결되는지 정확히 확인하려고 터미널에서 직접 플러그인을 설치했습니다. 익숙해진 뒤에는 에이전트가 채팅에서 직접 설치하도록 맡기기 시작했습니다. 아래에서 두 가지 방법을 모두 보여 드리겠습니다.

## 에이전트에 플러그인을 5분 만에 설치하려면 어떻게 하나요?

<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도 비슷합니다. 기능 묶음을 연결한 뒤 봇을 다시 시작합니다. 이름은 다르지만 순서는 같습니다. 소스를 연결하고 이름으로 설치한 다음 에이전트를 다시 시작합니다.

플러그인은 컨텍스트 엔지니어링을 구성하는 요소 중 하나입니다. 첫 요청을 보내기 전에 에이전트가 바로 사용할 기능을 정하는 것입니다. 체계적으로 작업하려면 다음 조합이 유용합니다. **AI 클론**(스킬과 플러그인에 담긴 사용자의 전문성) + **Second Brain**(프로젝트 지식의 구조) + **컨텍스트 엔지니어링**(에이전트에 무엇을 언제 제공할지). 이 세 가지가 없으면 AI는 추측하기 시작합니다.



## 플러그인은 어디서 찾고, 어떤 플러그인을 믿을 수 있나요?

<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 문서, https://docs.claude.com/en/docs/claude-code/discover-plugins</figcaption>
</figure>

쉽게 말하면 공식 마켓플레이스와 검토를 거친 마켓플레이스를 사용하면 안심할 수 있습니다. 아무 GitHub 저장소에서나 설치하려면 먼저 안에 무엇이 있는지 읽고 요청하는 권한이 왜 필요한지 이해해야 합니다. 서드파티 코드에 대한 신뢰는 플러그인 설치에만 국한되지 않습니다. [바이브 코딩 보안](https://ailoot.ai/blog/ko/vibe-coding-security/)에 관한 글에서 더 자세히 다룹니다.

## Telegram에서 플러그인이 설치되어 작동하는지 어떻게 확인하나요?

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

핵심 요점

에이전트에 명령 목록을 요청하거나 플러그인 패널을 여세요. 목록에 플러그인의 명령이 있으면 연결된 것입니다. 다음으로 채팅에서 간단한 테스트 작업을 맡겨 새 기능을 사용하는지 확인합니다. 아무것도 나타나지 않는다면 플러그인을 다시 로드하지 않았거나 잘못된 마켓플레이스를 연결했을 수 있습니다.

</div>

잠깐 시간을 내 확인하세요. “installed”가 표시되었다고 해서 봇이 플러그인을 실제로 불러왔다는 뜻은 아닙니다. 다음 단계를 따르세요.

1.  **목록을 확인합니다.** `/plugin` 패널을 다시 열거나 에이전트에게 사용 가능한 명령을 보여 달라고 요청합니다. Claude Code에서는 새 플러그인의 명령이 목록에 표시되고 플러그인 이름이 접두사로 붙습니다.
2.  **테스트 작업을 맡깁니다.** 실제 작업이 아니라 안전한 작업을 선택하세요. GitHub 플러그인을 설치했다면 최근 커밋을 보여 달라고 하세요. 검토 플러그인을 설치했다면 작은 파일을 건네세요. 한 가지를 확인하면 됩니다. 봇이 새 기능을 사용해 그 작업을 맡아 처리하나요?
3.  **실제로 사용하는 채팅에서 확인합니다.** Telegram으로 에이전트를 제어한다면 Telegram에서 테스트 명령을 보냅니다. 터미널에는 플러그인이 표시되지만 채팅의 봇은 아직 다시 로드하지 않은 경우가 있습니다.

플러그인이 설치됐는데 명령이 작동하지 않는 가장 흔한 이유는 다시 로드하는 단계를 건너뛰었기 때문입니다. 설치 명령은 성공했지만 열린 대화의 에이전트가 여전히 이전 기능을 사용하고 있습니다. `/reload-plugins`를 실행하면 해결됩니다. 그래도 안 되면 봇을 완전히 다시 시작하세요. 두 번째 이유는 다른 마켓플레이스에서 설치한 경우입니다. 플러그인 이름은 맞지만 디렉터리가 잘못되었으므로 에이전트는 해당 플러그인이 연결된 마켓플레이스에 없다고 알립니다.

봇이 채팅에서 응답하지만 새 명령을 이해하지 못해도 에이전트가 고장 났거나 사용자가 뭔가 잘못했다는 뜻은 아닙니다. 거의 대부분 두 가지 중 하나입니다. 플러그인을 다시 로드하지 않았거나 잘못된 마켓플레이스를 연결한 것입니다. 둘 다 1분이면 해결할 수 있습니다.

## 에이전트를 어지럽히지 않고 플러그인을 업데이트하고 제거하려면 어떻게 하나요?

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

핵심 요점

먼저 한 가지 명령으로 마켓플레이스를 업데이트해야 새 플러그인 버전을 사용할 수 있습니다. 플러그인 제거도 설치만큼 간단합니다. 같은 패널을 사용하면 됩니다. 실제로 사용하는 플러그인만 연결해 두세요. 플러그인이 추가될 때마다 봇의 명령이 늘고 컨텍스트도 더 차지합니다.

</div>

업데이트에는 쉽게 알아차리기 어려운 점이 있습니다. 작성자가 새 버전을 공개해도 자동으로 들어오지 않습니다. 먼저 `/plugin marketplace update`로 마켓플레이스 디렉터리를 업데이트한 뒤 새 버전을 설치해야 합니다. 마켓플레이스를 업데이트하기 전까지 에이전트는 지난번에 다운로드한 버전을 최신 버전으로 간주합니다. 이는 의도된 방식입니다. 다른 사람의 변경 사항이 사용자 모르게 나중에 끼어들지 않도록 합니다.

설치할 때 사용한 것과 같은 `/plugin` 패널에서 플러그인을 제거합니다. 설치된 목록에서 플러그인을 찾아 제거하세요. 에이전트에 흔적이 남지 않고, 다시 로드하면 명령도 사라집니다. 그래서 플러그인은 부담 없이 시험해 볼 수 있습니다. 여러 개를 설치하고, 잘 작동하는 두 개만 남긴 뒤 나머지는 제거하세요.

그리고 깔끔하게 유지하세요. 연결된 플러그인은 에이전트가 기억해야 할 명령을 추가하고 설명을 위해 컨텍스트 창의 일부를 사용합니다. 사용하지 않는 플러그인 다섯 개는 봇을 불필요하게 느리게 하고 혼란스럽게 합니다. 간단한 원칙은 이렇습니다. 2주 동안 유용하지 않았던 플러그인은 제거하세요. 명령 하나로 다시 설치할 수 있습니다.

## 어떤 플러그인을 먼저 설치하면 좋을까요?

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

핵심 요점

세 가지 분야부터 시작하세요. GitHub 작업, 코드 검토, 일관된 스타일의 커밋입니다. 프로젝트를 만들고 채팅에서 에이전트를 관리하는 사람이라면 거의 누구나 필요합니다. 나머지는 특정 작업에 맞춰 추가하세요. 플러그인을 미리 설치할 필요는 없습니다. 사용하지 않는 플러그인은 봇을 느리게 할 뿐입니다.

</div>

상위 100개 목록은 제공하지 않겠습니다. 별도의 가이드가 필요한 주제이고, 이미 Claude Code 플러그인 상위 10개에 관한 글이 있습니다. Telegram에서 에이전트를 관리하는 초보자에게 권하는 세 가지 분야를 소개합니다.

1.  **GitHub 작업.** 에이전트에 커밋, 브랜치, pull request 명령을 제공하는 플러그인입니다. 채팅에서 봇에 “작업을 저장해서 저장소에 푸시해”라고 쓰면 알아서 처리합니다. 경험이 많지 않은 상태에서 바이브 코딩을 하는 사람들이 가장 걱정하는 문제, 즉 코드를 잃어버릴 두려움을 덜어 줍니다.
2.  **코드 검토.** 오류, 보안 취약점, 약점을 확인하는 체크리스트가 포함된 플러그인입니다. Telegram에서 특히 유용합니다. 채팅에 코드 일부를 보내면 에디터를 열지 않고도 검토 결과를 받을 수 있습니다.
3.  **일관된 스타일의 커밋.** 에이전트가 하나의 템플릿에 따라 커밋 형식을 맞추도록 하는 작은 플러그인입니다. 사소해 보일 수 있지만 한 달이 지나면 프로젝트 이력이 엉망이 되는 대신 팀이 관리한 것처럼 깔끔해집니다.

그다음에는 특정 작업에 맞는 플러그인을 선택하세요. 데이터베이스를 사용하나요? 데이터베이스 플러그인을 고르세요. 요약을 작성하나요? 일정 관리 플러그인을 고르세요. 기본 원칙은 같습니다. 작업에서 출발한 뒤 그에 맞는 플러그인을 찾으세요. “혹시 모르니” 미리 플러그인을 설치하는 것은 사용하지 않을 명령으로 봇을 가득 채우는 확실한 방법입니다.

## 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 에이전트에 설치되며, 에이전트는 컴퓨터나 서버에서 실행됩니다. 메신저 안에 설치되는 것이 아닙니다.

플러그인을 신뢰할 수 있는지 어떻게 알 수 있나요?

출처와 권한 목록을 확인하세요. 공식 마켓플레이스는 공급업체가 운영하며, 커뮤니티 플러그인은 자동 검사를 통과하고 특정 버전으로 고정되어 있습니다. 설치 전에 에이전트가 플러그인에 추가될 항목을 정확히 보여 줍니다. 메모 확장 기능이 터미널 접근을 요구한다면 주의하고 설치하지 말아야 할 이유가 됩니다.

설치 후 플러그인이 작동하지 않으면 어떻게 해야 하나요?

거의 대부분 두 가지 중 하나가 원인입니다. 설치 후 플러그인을 다시 로드하지 않았거나 잘못된 마켓플레이스를 연결한 것입니다. 에이전트에 플러그인을 다시 로드하라고 하고, 그래도 해결되지 않으면 봇을 완전히 다시 시작하세요. 평소 사용하는 채팅에서 확인하세요. 터미널에는 플러그인이 보이지만 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/ko/choose-claude-code-skills/)
- [가이드: 바이브 코딩 보안](https://ailoot.ai/blog/ko/vibe-coding-security/)

</div>

체계적으로 작업하려면 **AI 클론 + Second Brain + 컨텍스트 엔지니어링** 조합이 유용합니다.





[Ailoot 열기](https://ailoot.ai/).

## AI 에이전트 Telegram 봇용 플러그인: 설치 및 확인: 자주 묻는 질문

### 설치한 플러그인이 Telegram에서는 작동하지 않는 이유는 무엇인가요?

실행 중인 에이전트가 아직 로드하지 않았을 수 있습니다. 플러그인을 다시 로드하거나 봇을 다시 시작하고 같은 Telegram 채팅에서 명령을 확인한 뒤 무해한 시험을 하세요. 설치 출력만으로 활성 세션의 로드를 입증할 수 없습니다.

### 서버에서 봇이 실행된다면 플러그인을 어디에 설치하나요?

봇이 실행되는 컴퓨터의 에이전트에 설치하세요. Telegram은 메시지를 전달하고 답변을 표시할 뿐 에이전트 확장을 저장하지 않습니다. 설치 전에 출처와 추가되는 기능을 확인하세요.


## Ailoot · 회사와 그 프로젝트 포트폴리오

Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.
