초급

5단계로 만드는 오픈클로 멀티 에이전트 텔레그램 그룹 채팅! 고급 해킹 팁 포함! (실전 가이드 + 이해 못 하면 제 잘못)

5단계로 만드는 오픈클로 멀티 에이전트 텔레그램 그룹 채팅! 고급 해킹 팁 포함! (실전 가이드 + 이해 못 하면 제 잘못)

팁: 모든 사람이 여러 개의 오픈클로 에이전트를 필요로 하는 것은 아닙니다. 실제 업무 요구에 따라 생성하세요. 많다고 항상 좋은 것은 아닙니다. 이 점을 명심하세요.
참고로, 이 가이드는 이미 오픈클로가 설치되어 있다고 가정합니다! 설치되어 있지 않다면 다른 설치 튜토리얼을 확인하세요!
오픈클로 구성에 익숙하지 않다면 이전 가이드를 확인하세요: 오픈클로 성장 일기, 제로부터! 설치 후 필독! (40일 실전 경험 + 역할 프롬프트 포함) 내용: https://x.com/berryxia/status/2028668902465733084

핵심부터 말하자면#

여러 역할의 AI 팀을 만들려면 여러 봇 계정과 여러 서버가 필요하다고 생각하시나요?
그렇지 않습니다.
하나의 게이트웨이, 하나의 봇, 몇 개의 텔레그램 그룹만 있으면 제품 관리자, QA, 엔지니어, 콘텐츠 크리에이터 등 여러 역할이 동시에 온라인 상태로, 서로 간섭 없이 독립적으로 작업하며, 심지어 서로를 호출할 수도 있습니다.
이것은 마법이 아닙니다. 이것이 오픈클로 그룹 라우팅 메커니즘의 힘입니다.

두 가지 아키텍처, 필요에 따라 선택#

아키텍처 1: 단일 봇, 여러 그룹 (초보자 추천)
plaintext
하나의 봇 토큰
    ├── 그룹 A → 에이전트 A (제품 관리자)
    ├── 그룹 B → 에이전트 B (엔지니어)
    └── 그룹 C → 에이전트 C (QA)
장점: 구성이 간단하며, 하나의 봇으로 모든 것을 처리합니다. 최적 대상: 개인 사용, 소규모 팀.
plaintext
아키텍처 2: 여러 봇, 여러 에이전트 (고급 플레이)
게이트웨이
    ├── 봇 A (누오누오) → 기본 에이전트
    ├── 봇 B (투안투안) → 생활 에이전트 (생활 도우미)
    └── 봇 C (아이아이) → AI 에이전트 (기술 전문가)
장점: 각 봇은 독립적인 성격, 격리된 메모리, 분리된 컨텍스트를 가집니다. 최적 대상: 여러 시나리오, 여러 역할, 메모리 격리가 필요한 경우.

문제점은 무엇인가?#

분명 이런 상황을 겪어보셨을 겁니다:
텔레그램에서 여러 AI 역할을 동시에 실행하고 싶습니다. 하나는 코드를 작성하고, 하나는 테스트 케이스를 작성하고, 하나는 제품 분석을 수행하는 식으로요. 하지만 온라인 튜토리얼에서는 각 역할마다 자체 봇, 자체 토큰 구성, 자체 실행 게이트웨이가 필요하다고 알려줍니다...
세 번째 봇을 구성할 즈음이면 인생에 대한 의문이 들기 시작할 것입니다.
더 교활한 함정이 있습니다: 비디오 튜토리얼입니다.
정보 밀도가 극도로 높은 9분짜리 "단계별 튜토리얼"은 계속해서 일시 정지, 되감기, 스크린샷을 찍도록 강요합니다. 간신히 따라가다가도 한 단계를 놓쳐서 처음부터 다시 시작해야 한다는 것을 깨닫게 됩니다.
이 글은 바로 그 문제를 해결하기 위해 존재합니다.

핵심 원리 (한 문장으로 설명)#

게이트웨이: 오픈클로의 "두뇌"로, 메시지 수신, LLM 호출, 결과 반환을 담당합니다. AI의 로컬 프록시 서버라고 생각하면 됩니다.
하나의 게이트웨이는 여러 에이전트를 호스팅할 수 있습니다. 각 에이전트는 "그룹 라우팅"을 통해 다른 텔레그램 그룹에 바인딩됩니다.
그룹 A에 메시지를 보내면 게이트웨이는 이를 "제품 관리자 에이전트"에게 전달하여 처리합니다. 그룹 B에 메시지를 보내면 게이트웨이는 이를 "엔지니어 에이전트"에게 전달하여 처리합니다.
핵심: 동일한 봇 계정을 공유하지만 독립적인 메모리, 권한 및 작업 공간을 가집니다.

구성을 완료하는 5단계#

1단계: 메인 봇 생성 (5분)
이 단계는 기본입니다. 모든 하위 에이전트의 "호스트" 역할을 할 "마스터 봇"을 생성해야 합니다.
  1. 텔레그램에서 @BotFather를 검색하고 /newbot을 보냅니다.
메인 BOT 생성
  1. 봇 이름을 지정합니다 (예: lifezhushou).
  2. 사용자 이름을 설정합니다 (bot으로 끝나야 함, 예: lifezhushou_bot).
  3. 반환된 토큰을 복사합니다 (123456:ABC-DEF... 형식).
토큰 저장, 비밀 유지
중요: 이 토큰 값을 유출하지 마십시오!
그런 다음 이 토큰을 사용하여 봇을 오픈클로에 연결합니다:
PS: 이 토큰을 오픈클로에 보내서 진행하도록 할 수도 있습니다.
bash
openclaw config
bash
# 채널 → 텔레그램으로 이동 → 토큰 붙여넣기
최종 페어링 단계:

Telegram에서 봇에게 비공개 메시지를 보내고, /start를 입력하여 페어링 코드를 받으세요#

bash
openclaw pairing approve telegram <Your Pairing Code>
페어링 코드: "인증 코드"와 유사하며, 이 봇을 작동할 권한이 있음을 확인하는 데 사용됩니다. 한 번 페어링하면 영구 유지됩니다.
PS: 더 간단한 고급 꿀팁이 있습니다. 이미 설정된 OpenClaw에 이 내용을 직접 보내서 작동 단계를 학습시키면 됩니다.
그룹 채팅을 만들 때 단계별로 안내해 줍니다. 이것이 가장 편리한 방법입니다(이러한 항목을 찾는 방법을 모르는 경우).

2단계: 그룹 권한 활성화 (건너뛰지 마세요!)#

가장 쉽게 실수하는 부분입니다.
기본적으로 봇은 "프라이버시 모드"가 활성화되어 있어 @멘션이 있는 메시지만 볼 수 있습니다. 이 기능을 끄지 않으면 봇이 그룹에서 "귀머거리"가 됩니다.
@BotFather로 돌아가기
BotSetting 설정
BotSetting 설정
그룹 프라이버시 설정
그룹 프라이버시 설정
프라이버시 모드 끄기
프라이버시 모드 끄기
plaintext
/mybots → 봇 선택 → Bot Settings
  → Allow Groups: 활성화
  → Group Privacy: 비활성화
핵심: 이러한 변경 후에는 반드시 봇을 그룹에서 추방한 후 다시 추가해야 합니다. 다시 추가하지 않으면 설정이 적용되지 않습니다. 많은 사람들이 오랜 시간 설정해도 응답이 없는 근본적인 이유입니다.

3단계: 그룹 생성, 그룹 ID 얻기#

각 하위 에이전트는 전용 그룹이 필요합니다. 그룹의 ID가 "라우팅 주소"입니다.
  1. 새 텔레그램 그룹을 만듭니다(역할 이름으로 지정하는 것이 좋습니다. 예: 새우 친구들)
  2. 메인 봇을 그룹에 추가합니다.
  3. 그룹에서 봇을 @멘션하고 "현재 그룹의 ID가 무엇인가요?"라고 물어봅니다.
그룹 ID 정보
  1. 봇이 음수 문자열(예: -1001234567890)로 응답합니다.
이 ID를 복사하여 저장합니다. 다음 단계에서 필요합니다.
그룹 ID: 텔레그램 그룹의 고유 식별자로, 음수로 시작합니다. 봇은 이 ID를 사용하여 메시지가 어떤 그룹에서 왔는지 알 수 있습니다.

4단계: 프롬프트를 사용하여 하위 에이전트 자동 생성 (핵심 단계)#

전체 과정에서 가장 중요한 단계입니다.
메인 봇과의 비공개 채팅 창으로 돌아가서 다음 프롬프트를 보냅니다. 대괄호 안의 내용만 자신의 정보로 바꾸면 됩니다.
plaintext
지금부터 당신은 나의 OpenClaw 마스터 에이전트입니다. 다음 단계를 엄격히 따라 나를 위한 완전히 새롭고 독립적인 하위 에이전트를 생성해 주세요:

1. 에이전트 기본 정보:
- 이름: 【하위 에이전트 이름, 예: 제품 관리자】
- 모델: 【모델, 예: Claude-3-6-sonnet 또는 GLM5】
- 워크스페이스: 새 독립 워크스페이스 생성 (이름과 동일하게 지정)
- 성격: 【역할 설명, 예: "당신은 시니어 제품 관리자로, 요구사항 분석, 사용자 조사, 제품 기획에 능숙합니다."】

2. 라우팅 바인딩 구성:
- accountId: "main" 사용
- 두 개의 peer 유형 바인딩:
  - peer.kind: "group", peer.id: 【그룹 ID】
  - peer.kind: "channel", peer.id: 【위와 동일】
- 모든 메시지를 이 새 에이전트로 라우팅

3. 그룹 정책:
- requireMention: false (@멘션 없이도 그룹에서 직접 응답 가능)
- groupPolicy: "open" (모든 사용자 메시지 표시)
- allowFrom: ["*"] (권한 개방)

4. 메시지 가로채기 방지:
- 메인 에이전트에 "direct" 클라이언트 + 사용자 ID 화이트리스트 추가

위 구성을 즉시 실행하고 완료 시 확인 메시지를 보내 주세요.
보낸 후 10-30초 기다립니다. 메인 에이전트가 자동으로 하위 에이전트를 생성하고 확인 메시지를 반환합니다.
워크스페이스: 각 에이전트의 "독립 사무실"로, 자체 메모리, 파일 및 구성을 포함합니다. 에이전트 간에는 간섭이 없습니다.

5단계: 테스트, 그리고 더 많은 역할 추가#

여러 역할 생성 후
방금 만든 그룹으로 이동하여 메시지를 직접 보냅니다.
plaintext
휴대폰에서 오늘 최신 AI 뉴스를 찾아줘
하위 에이전트가 정상적으로 응답하면 축하합니다! 첫 번째 역할이 성공적으로 구성되었습니다!
다음으로 3단계와 4단계를 반복하여 더 많은 역할을 만듭니다.
  • QA 에이전트: 테스트 케이스 작성, 버그 찾기에 능숙
  • 엔지니어 에이전트: 코드 작성, 아키텍처 설계
  • 콘텐츠 에이전트: 트윗 작성, 카피 제작
각 역할은 자체 그룹을 가지며 독립적으로 작동하여 간섭이 없습니다.
더 멋진 점은 메인 봇의 비공개 채팅에서 이들을 "오케스트레이션"하여 협업할 수 있다는 것입니다.
plaintext
에이전트 A와 에이전트 B가 A가 준 작업 또는 다른 작업을 실행하고 결과를 당신에게 제출하게 하세요.
여기에는 코드 작성, 카피 작성 등 모든 것이 포함됩니다.
메인 에이전트가 자동으로 해당 하위 에이전트를 호출하고 결과를 요약하여 제공합니다.

고급 활용: 멀티 봇 구성#

시나리오를 더 명확하게 분리해야 할 때 여러 봇을 구성하고 각각 다른 에이전트에 바인딩할 수 있습니다.

구성 예시#

json
{
  "channels": {
    "telegram": {
      "accounts": {
        "main": {
          "botToken": "메인 봇 토큰",
          "groups": { "*": { "requireMention": false } }
        },
        "life": {
          "botToken": "생활 도우미 봇 토큰",
          "groups": { "*": { "requireMention": true } }
        },
        "xiaoxiamiss": {
          "botToken": "기술 전문가 봇 토큰",
          "groups": { "*": { "requireMention": true } }
        }
      }
    }
  }
}

시나리오: 한 그룹에 여러 봇, 혼란을 피하는 방법?#

옵션 1: 기본 응답자
  • 지정 없음누오누오(기본)가 응답
  • @투안투안투안투안이 응답
  • @아이아이아이아이가 응답
옵션 2: 모두 @멘션 필요
  • 모든 봇에 requireMention: true 설정
  • 호출한 봇만 응답

권한 관리#

비공개 채팅 권한#

json
{
  "dmPolicy": "pairing"
}

그룹 권한#

json
{
  "groupPolicy": "allowlist",
  "allowFrom": [
    1867306242,
    -5095174939
  ]
}

더 많은 사람에게 개방#

볼 필요 없이 OpenClaw에 지시하세요

메모리 격리#

각 에이전트는 독립적인 워크스페이스를 가지며 메모리가 서로 격리됩니다.
yaml
workspace-life/
  ├── IDENTITY.md      # 투안투안의 정체성
  ├── MEMORY.md        # 투안투안의 장기 기억
  └── memory/          # 투안투안의 일기

workspace-ai/
  ├── IDENTITY.md      # 아이아이의 정체성
  ├── MEMORY.md        # 아이아이의 장기 기억
  └── memory/          # 아이아이의 일기

문제 발생 시 대처 방법#

봇이 그룹에서 메시지에 응답하지 않음#

체크리스트:

봇이 서로 메시지를 가로챔#

requireMention 구성을 확인하세요.
  • false: @멘션 없이 응답 가능
  • true: 응답하려면 @멘션 필요
권장: 하나의 봇만 false로 설정하고 나머지는 모두 true로 설정하세요.

상세 로그를 보고 싶나요?#

bash
openclaw logs --follow
모든 메시지 라우팅 상황을 실시간으로 확인할 수 있어 문제 해결에 매우 편리합니다.
OpenClaw 슈퍼 치트 시트

일반적인 시나리오 설정#

시나리오 1: 개인 비서 + 기술 컨설턴트
  • NuoNuo (기본값): 일상 대화, 생활 비서
  • AiAi (@ 필요): 기술 질문, 코드 개발
시나리오 2: 팀 협업
  • 그룹 A - 제품 관리자: 요구사항 분석, 사용자 조사
  • 그룹 B - 엔지니어: 코드 구현, 아키텍처 설계
  • 그룹 C - QA: 테스트 케이스, 버그 분석
시나리오 3: 다국어 서비스
  • 봇 A: 중국어 고객 서비스
  • 봇 B: 영어 고객 서비스
  • 봇 C: 일본어 고객 서비스

게이트웨이 토큰 획득#

API를 통해 게이트웨이에 접근해야 하는 경우:
bash
cat ~/.openclaw/openclaw.json | grep -A2 '"auth"'
토큰은 다음 용도로 사용됩니다:
  • API 호출
  • 원격 관리
  • 타사 통합

마지막으로#

AI 시대에는 한 사람이 곧 하나의 팀이 될 수 있습니다.
이전에는 제품 관리자, QA, 엔지니어를 동시에 운영하려면 세 개의 환경을 설정하고 세 개의 봇을 구성해야 했습니다. 이제는 하나의 게이트웨이로 모든 것을 처리합니다.
이는 기술적 역량을 과시하기 위한 것이 아니라 효율성 혁명입니다.
AI를 사용하여 제품 개발, 코드 작성, 콘텐츠 제작을 하고 있다면 이 설정 방법에 15분만 투자해 볼 가치가 있습니다. 설정이 완료되면 Telegram이 "AI 전쟁실"로 변신하여 언제든지 다양한 역할을 소환해 협업할 수 있습니다.