Skip to content

Telegram 봇 설정

Claw Buff AI 에이전트를 Telegram에 연결하는 단계별 가이드

Claw Buff AI 에이전트를 Telegram에 연결하면, 사용자가 DM이나 그룹 채팅으로 에이전트와 대화할 수 있어요. 설정은 약 5분이면 완료됩니다.

사전 준비

  • Telegram 계정
  • 배포된 Claw Buff 에이전트 (시작하기)

1단계: BotFather로 봇 만들기

BotFather 열기

Telegram을 열고 @BotFather를 검색하세요 (파란색 인증 체크마크를 확인하세요). Telegram의 공식 봇 생성 및 관리 도구입니다.

봇 생성하기

BotFather에게 /newbot을 보내고 안내에 따르세요:

  1. 봇 이름 — 봇의 표시 이름 (예: "My AI Assistant")
  2. 봇 사용자 이름 — 반드시 bot으로 끝나야 해요 (예: my_claw_bot)

봇 토큰 저장하기

BotFather가 다음과 같은 형식의 봇 토큰을 회신해요:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

이 토큰을 복사해 두세요 — 다음 단계에서 필요해요.

봇 토큰은 반드시 비밀로 유지하세요. 토큰이 있으면 누구나 봇을 제어할 수 있어요. 공개 채팅이나 Git에 절대로 공유하지 마세요.

2단계: Claw Buff에 연결하기

  1. Claw Buff 콘솔 → 채널 페이지를 여세요
  2. Telegram 카드를 찾고 연결을 클릭하세요
  3. 1단계에서 받은 봇 토큰을 붙여넣으세요
  4. 저장 및 활성화를 클릭하세요

몇 초 안에 에이전트가 Telegram에 연결돼요. 상태가 연결됨으로 변경되는 것을 확인할 수 있어요.

3단계: 접근 권한 부여하기

기본적으로 봇은 페어링 모드로 작동해요 — 새로운 사용자는 대화하기 전에 승인을 받아야 해요. 처음 봇에 메시지를 보내면 다음과 같은 안내가 표시돼요:

OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234

대기 중인 요청으로 승인하기

Claw Buff 콘솔 → 채널 페이지로 이동하세요. 접근을 요청한 사용자가 있으면 대기 중인 페어링 요청 섹션이 자동으로 표시되며, 대기 중인 코드가 나타나요. 요청 옆의 승인을 클릭하세요.

페어링 코드는 1시간 후에 만료돼요. 만료된 경우 사용자가 봇에 다시 메시지를 보내면 새 코드를 받을 수 있어요.

인증된 사용자 관리하기

Telegram 채널 카드에서 관리를 클릭하면 접근 권한을 직접 관리할 수도 있어요:

  • 현재 인증된 모든 사용자 확인
  • Telegram 사용자 ID를 입력하여 사용자를 추가 (사전 인증)
  • 사용자를 제거하여 접근 권한 취소

4단계: 대화 시작하기

Telegram을 열고, 봇의 사용자 이름으로 봇을 찾아 메시지를 보내 보세요. AI 에이전트가 응답할 거예요!

그룹 채팅 설정

Telegram 그룹에서 봇을 사용하려면:

  1. 봇을 그룹에 추가하세요
  2. 기본적으로 봇은 @멘션되었을 때만 응답해요

그룹에서는 봇이 멘션되었을 때만 응답해요 (예: @my_claw_bot 날씨 어때?). 이렇게 하면 활발한 그룹에서 모든 메시지에 봇이 반응하는 것을 방지할 수 있어요.

지원 기능

기능지원 여부
다이렉트 메시지지원
그룹 채팅지원 (멘션 필요)
스트리밍 응답지원 (실시간 타이핑)
서식 지원지원 (HTML/Markdown)
포럼 토픽지원
파일 첨부지원

자주 묻는 질문

1. 봇이 응답하지 않나요?

  • 토큰 확인 — 토큰을 빈칸 없이 정확하게 붙여넣었는지 확인하세요
  • 콘솔 확인 — 채널 페이지에서 연결 상태와 오류 로그를 확인하세요
  • 네트워크 문제 — 에이전트가 포트 443에서 api.telegram.org로 아웃바운드 접근이 가능해야 해요

2. 봇 응답이 느린가요?

스트리밍은 기본적으로 활성화되어 있어요. AI가 응답을 생성하는 동안 봇이 실시간으로 메시지를 편집해요. 지연이 발생하면 콘솔 → 에이전트 → 모델에서 모델 설정을 확인하세요.

3. "Forbidden: bot was blocked by the user" 오류가 나오나요?

사용자가 Telegram에서 봇을 차단한 상태예요. 차단을 해제하고 /start를 다시 보내야 해요.