오픈클로 텔레그램 연동 디스코드 봇 설정 방법 (OpenClaw 메신저 세팅)

오픈클로 텔레그램 연동 디스코드 봇 설정 방법 (OpenClaw 메신저 세팅)

오픈클로 텔레그램 연동 디스코드 봇 설정 섬네일

OpenClaw를 실제로 운영하다 보면 “텔레그램은 되는데 디스코드가 안 붙는다”거나, 반대로 “디스코드는 연결됐는데 DM 승인이 막힌다” 같은 상황이 자주 생기는데요.

저 같은 경우에도 처음에는 토큰만 넣으면 끝날 줄 알았는데, 실제로는 정책값(dmPolicy, groupPolicy)과 인텐트 설정까지 맞춰야 안정적으로 동작하더라구요.

그렇기에 이번 포스팅에서는 OpenClaw 메신저 세팅 기준으로 텔레그램 연동, 디스코드 봇 설정, 페어링 승인, 테스트까지 한 번에 정리해보겠습니다.

1. 시작 전 준비사항

OpenClaw 메신저 세팅은 순서를 지키는 게 가장 중요합니다.

1> 텔레그램 BotFather 토큰 준비
2> 디스코드 Bot Token + 인텐트 설정 준비
3> OpenClaw 채널 정책값(dmPolicy, groupPolicy) 준비

개인적으로는 초반에 dmPolicy: "pairing"으로 시작하고, 그룹/길드는 allowlist 중심으로 좁혀두는 편이 운영 리스크가 훨씬 낮았습니다.

2. 텔레그램 봇 생성 및 OpenClaw 연결

텔레그램은 @BotFather에서 /newbot으로 토큰을 발급받는 구조인데요. 여기서 받은 토큰을 OpenClaw의 channels.telegram.botToken에 넣어주시면 됩니다.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABCDEF...",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

그리고 텔레그램은 그룹에서 개인정보/노이즈 이슈가 잘 생기기 때문에, 초반에는 멘션 기반(requireMention: true)으로 운영해보시는 편이 좋습니다.

3. 디스코드 봇 생성 및 OpenClaw 연결

디스코드는 Developer Portal에서 앱 생성 후 Bot을 추가하면 되는데요. 이때 인텐트를 놓치면 거의 반드시 막힙니다.

1> Message Content Intent : 사실상 필수
2> Server Members Intent : 역할 기반 허용/매칭 시 필수급
3> OAuth에서 bot, applications.commands 스코프 설정

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "DISCORD_BOT_TOKEN_VALUE",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}

4. OpenClaw 메신저 통합 설정 예시

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABCDEF...",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "enabled": true,
      "token": "DISCORD_BOT_TOKEN_VALUE",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}

OpenClaw는 메시지가 들어온 채널로 다시 응답을 돌려주는 결정적 라우팅 구조라서, 채널 혼선은 설정으로 막는 게 핵심입니다.

5. 페어링 승인과 테스트

openclaw gateway status
openclaw gateway start

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

openclaw pairing list discord
openclaw pairing approve discord <CODE>

openclaw message send --channel telegram --target 123456789 --message "telegram test"
openclaw message send --channel discord --target user:123456789012345678 --message "discord dm test"

6. 자주 막히는 포인트 정리

1> 디스코드 Message Content Intent 미활성화
2> 디스코드 길드/채널 allowlist 누락
3> 텔레그램 그룹 Privacy Mode 설정 누락
4> 페어링 코드 만료 후 승인 시도
5> 토큰 재발급 후 설정 미반영
6> 설정 변경 후 게이트웨이 재시작 누락

openclaw channels status --probe
openclaw logs --follow

7. 맺음말

오늘은 OpenClaw 메신저 세팅 기준으로 텔레그램 연동과 디스코드 봇 설정 방법을 한 번에 정리해봤습니다.

개인적으로는 “토큰 입력”보다 “정책 설계(dmPolicy/groupPolicy) + 페어링 승인 루틴”이 실제 운영 품질을 좌우하더라구요.

처음에는 다소 번거롭게 느껴질 수 있는데요. 한 번 구조를 제대로 잡아두면 이후에는 채널을 추가하거나 운영 범위를 넓힐 때 훨씬 안정적으로 확장할 수 있겠다 싶네요.

RECENT POSTING