OpenClaw 설치 + Telegram 연동 가이드 (실제 명령어 포함)

🚀 OpenClaw 설치 + Telegram 연동 실전 가이드

 

안녕하세요.

이번 글은 OpenClaw를 처음 설치한 뒤 Telegram과 연동해 실제로 동작시키는 과정까지, 실전 기준으로 정리한 튜토리얼입니다.

 

이 글은 Telegram으로 OpenClaw를 연동한 환경에서 작성했습니다.

 

────────────────────────

📌 3줄 요약

────────────────────────

1) Bot Token + chat_id만 정확하면 연동의 80%는 끝납니다.

2) 문제 발생 시 `openclaw status --deep`에서 대부분 원인 확인이 가능합니다.

3) getUpdates 결과가 비면 먼저 봇에게 `/start`를 보내세요.

 

 

✅ 준비물

- macOS 환경

- Telegram 계정

- BotFather(@BotFather)

- OpenClaw 설치 완료 상태

 

 

────────────────────────

STEP 1. OpenClaw 상태 점검

────────────────────────

설치 직후에는 반드시 상태를 먼저 확인합니다.

 

openclaw status

 

상세 진단이 필요하면:

openclaw status --deep

 

체크 포인트

- Gateway reachable

- Sessions active

- Telegram channel 상태 OK

 

 

────────────────────────

STEP 2. Telegram Bot 만들기

────────────────────────

1) Telegram에서 @BotFather 접속

2) /newbot 실행

3) 봇 이름/유저네임 설정

4) Bot Token 발급

 

⚠️ 주의

Bot Token은 비밀번호와 동일합니다.

외부 채팅/스크린샷/깃 커밋에 절대 노출하지 마세요.

 

 

────────────────────────

STEP 3. chat_id 확인

────────────────────────

많이 헷갈리는 부분입니다.

@username이 아니라 숫자형 chat_id가 필요합니다.

 

절차

- 봇 채팅방에서 /start 전송

- 일반 메시지 1개 전송

- 아래 주소 호출

 

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates

 

응답에서 확인할 값

- chat.id (예: 7992536188)

 

 

────────────────────────

STEP 4. OpenClaw Telegram 설정 반영

────────────────────────

핵심 설정 항목

- channels.telegram.enabled

- channels.telegram.botToken

- channels.telegram.dmPolicy

 

설정 반영 후 재확인

openclaw status --deep

 

 

────────────────────────

STEP 5. 송수신 테스트

────────────────────────

Telegram API 직접 테스트

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendMessage?chat_id=<CHAT_ID>&text=OpenClaw%20test

 

응답에 ok:true가 뜨면 API 경로는 정상입니다.

 

이제 Telegram에서 봇에게 직접 메시지를 보내고,

OpenClaw 응답이 오는지 확인하면 연동 완료입니다.

 

 

────────────────────────

🧯 트러블슈팅

────────────────────────

[문제 1] 401 Unauthorized

- 원인: 토큰 오타 / 재발급 후 구 토큰 사용

- 해결: BotFather에서 새 토큰 발급 후 설정값 갱신

 

[문제 2] getUpdates 결과가 비어 있음(result: [])

- 원인: 봇이 사용자 메시지를 아직 못 받음

- 해결: /start + 일반 메시지 전송 후 재조회

 

[문제 3] 봇은 보내는데 응답이 없음

- 점검: dmPolicy / allowFrom / Gateway 상태 / chat_id 정확성

 

 

────────────────────────

🔐 보안 체크리스트

────────────────────────

- Bot Token/API Key 외부 노출 금지

- 로그/캡처 공유 시 민감정보 마스킹

- 노출 의심 시 즉시 토큰 폐기 및 재발급

 

 

────────────────────────

마무리

────────────────────────

OpenClaw + Telegram 연동은 아래 3가지만 정확하면 안정적으로 운영할 수 있습니다.

 

1. Bot Token 정확성

2. chat_id 정확성

3. 상태 점검 습관(openclaw status --deep)

 

다음 글에서는 실제 운영용으로

- 알림 자동화

- 간단한 작업 예약

- 문제 감지 루틴

까지 연결해보겠습니다.