[인공지능/OpenClaw] 오픈클로 디스코드 연동하기

ChatGPT와의 연동이 끝났으니 이제는 "채널"을 연동하고자 한다.

오픈클로에서 "채널(이하 메신저)"은 오픈클로와 대화할 수 있는 메신저를 의미하는데, 각 메신저는 게이트웨이를 통해 연결된다.

지원하는 메신저 목록은 여기서 확인할 수 있는데 아쉽게도 카카오톡은 없다.

그나마 한국에서 좀 쓸만한 것들 중에는 아래와 같은 사유로 디스코드로 선택했다.

- 왓츠앱 ( 본인이 사용하지 않음 )

- 텔레그램 ( 텔레그램의 경우 한 채널에 여러 봇을 못 붙인다는 얘기가 좀 있음 )

- 디스코드

- 슬랙 ( 개인용보단 업무용 아닐까 )

- 라인 ( 본인이 사용하지 않음 )

---

디스코드 서버 만들기

윈도우 기준 디스코드 설치하고 아래와 같은 단계로 우선 서버를 만들어야 한다

 

디스코드 좌측 상단에 위치한 "+" 버튼을 눌러 서버를 추가한다.

 

직접 만들기 클릭

 

질문을 건너뛰기

 

서버 이름을 적당히 넣어주고 만들기를 누르면

 

나만의 서버가 만들어진다.

---

디스코드 봇 만들기

서버를 만들었으니 이제 봇을 만들어야 한다. 봇은 오픈클로의 복사본 느낌으로 생각하면 된다.  우리가 디스코드에 어떤 채팅을 입력하면 그걸 복사본인 봇이 받아서 오픈클로에 넘기는 구조이다.

우선 디스코드 개발자 포탈로 이동한다.

 

"New Application" 클릭 후 앱의 이름을 입력한다.

 

그러면 앱의 페이지로 이동되는데 "Installation" 메뉴에 들어가서 "Install Link"을 "None"으로 바꾼다.

 

"OAuth2" 메뉴에서 Scopes와 Bot Permissions를 위와 같이 체크한다.

- Scopes의 경우 "bot"은 필수이며 "application.commands"는 슬래시 기반 명령어를 사용할 거면 추가 아니면 안 해도 된다.

- "Bot Permissions"의 경우 "View Channels", "Send Messages", "Read Message History"는 필수이며 나머지 것들은 원하는만큼 추가하면 된다. ( 나는 파일 첨부와 쓰레드 기능을 위해 위 사진과 같이 선택했다. )

그러면 URL 값이 나오는데 반드시 메모해두자.

 

"Bot" 메뉴에서 "Reset Token"을 눌러 토큰을 재발급 후 나오는 값을 반드시 메모한다.

 

(권장) 공용 봇 옵션은 기본으로 켜져 있는데 굳이 공용으로 할 필요가 없으니 나만 추가할 수 있게 끈다.

 

(옵션) Server Members Intent

- 디스코드 서버의 멤버 목록이나 멤버 상태 변화(서버 참가, 퇴장, 역할 변경 등) 관련 이벤트를 받아올 수 있게 해준다.

- 특정 역할을 가진 사람만 봇을 쓰게 한다거나, 역할에 따라 다른 규칙을 처리하게 한다거나 할 수 있게 해준다.

- 서버를 공용으로 쓸 꺼면 활성화 해주고, 개인용도로 쓸꺼면 꺼주면 된다.

(필수) Message Content Intent

- 서버의 메시지를 처리할 수 있게 해준다.

- 안 키면 멍청한 깡통 봇이 되버린다. 오픈클로와 대화를 하지 못하니 반드시 켜야 한다.

 

자 그러면 이제 "OAuth2" 메뉴 마지막에 나온 링크를 브라우저에 복사하면 위 사진처럼 나오는데 본인이 생성한 서버에 추가한다.

 

그러면 권한을 다시 한번 확인해서 승인하는 창이 뜨고, 승인까지 하면 성공 창이 뜬다.

 

봇이 성공적으로 추가 되면 디스코드 서버에 "착륙" 메시지가 나타난다. 

다만 아직 오픈클로에서 그 어떠한 설정도 하지 않았기에 말을 걸어도 딱히 반응을 하지 않는다.

---

오픈클로 설정하기

이전에 메모한 토큰 값을 사용할 차례이다.

 

openclaw config

이전 포스팅에서 OpenAI 연동하듯이 config 명령어를 이용해서 채널(메신저) 설정을 진행한다.

채널까지 선택하면 현재 상황이 나오는데 "install plugin to enable"로 된것들은 플러그인 설치 후 연동이 가능하며, 나머지는 바로 연동이 가능한 것들이다.

 

디스코드를 선택하면 봇 토큰을 입력하라고 하는데 기존에 메모한 값을 입력하면 된다.

 

그리고 나서 디스코드 채널 액세스를 오픈으로 설정하면 된다.

- 기본값이면서도 권장값은 허용할 특정 서버를 고르는건데 어차피 디스코드쪽에서 봇을 직접 추가했기에 오픈으로 설정하여도 무방하다.

---

디스코드 채팅하기 ( @ 태그 필수 )

기본적으로 봇과 채팅할 때는 여타 다른 SNS 마냥 "@" 태그를 해줘야한다.

---

디스코드 채팅하기 ( @ 태그 없이 )

위 사진처럼 봇과 대화를 하려면 꼭 태그를 해야 하는데 이게 여간 불편한게 아니다. 공용 서버면 어쩔 수 없겠지만 개인 서버라면 어차피 1:1 대화이기 때문에 태그 없이 바로 입력하는게 편한데 설정 파일을 약간 수정해야 한다.

 

설정 파일이 보통 "~/.openclaw/openclaw.json"에 있을텐데 아래처럼 디스코드 부분을 수정하면 된다.

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "xxxxxxxxxxxxxxxxxxxxxxxx",
      "groupPolicy": "open",
      "guilds": {
        "*": {
          "requireMention": false,
          "channels": {
            "*": { "allow": true, "requireMention": false }
          }
        }
      }
    }
  }
}