OpenClaw 멀티 플랫폼 설정 실전: 13개 Channel로 AI 어시스턴트 통합 관리하기

WhatsApp에서 AI에게 회의 일정을 정리하게 했는데, 회사에 도착해 Slack을 열어 보니 AI가 아침에 나눈 대화를 기억하지 못합니다. 저녁에 팀이 Discord에서 회의를 시작하면 또 똑같이 프로젝트 배경부터 설명해야 합니다. 크로스 플랫폼 AI 어시스턴트라면 어느 플랫폼에서든 사용자가 누구인지 기억할 수 있어야 합니다.

OpenClaw의 Channel 계층 구조는 메시지 정규화로 이 문제를 해결합니다. 한 번만 배포하면 Telegram, WhatsApp, Discord, Slack 등 13개 플랫폼을 연결할 수 있고, 모든 대화가 자연스럽게 동기화됩니다. Telegram의 sticker, Discord의 embed, WhatsApp의 음성도 하나의 형식으로 변환됩니다.

이 글에서는 Telegram(Token 발급까지 5분), WhatsApp(QR 코드 페어링), Discord(Bot 권한 설정) 세 플랫폼의 설정 과정과 크로스 플랫폼 세션 동기화 및 보안 설정 경험을 공유합니다.

저비용으로 ‘새우 키우기’: ArkClaw로 누구나 쉽게 AI Agent 사용하기

최근 화제가 된 OpenClaw(바닷가재)는 유용하지만 설정 난도가 너무 높다고 느끼셨나요? ByteDance Volcano Engine이 출시한 ArkClaw는 진입 장벽을 크게 낮췄습니다. 서버나 Token 설정을 따로 만질 필요 없이 클릭 한 번으로 브라우저를 제어하고, 스크립트를 실행하고, 캘린더를 관리하는 24시간 온라인 ‘AI 일꾼’을 사용할 수 있습니다.

무엇보다 정말 저렴합니다. 월 이용료는 9.9위안이며, 제 초대 코드 ZLKUK54M을 사용해 여기에서 가입하면 8.9위안만 내면 됩니다. 프로그래머라면 Coding Plan Pro에 가입해 무료로 이용할 수도 있습니다.

OpenClaw의 Channel 계층은 어떻게 작동할까요?

OpenClaw를 처음 살펴볼 때 한 가지 궁금한 점이 있었습니다. Telegram의 sticker, Discord의 embed, WhatsApp의 음성 메시지는 형식이 전혀 다른데 OpenClaw는 어떻게 이들이 ‘같은 언어’를 사용하게 만들까요?

답은 Channel Adapters 계층에 있습니다.

메시지 정규화의 마법

Telegram에서는 스티커를 보내고, Discord에서는 이미지가 포함된 embed 메시지를 보내며, WhatsApp에서는 음성을 보냈다고 가정해 보겠습니다. 각 플랫폼의 데이터 구조는 완전히 다르지만 Channel Adapters는 이를 OpenClaw가 이해할 수 있는 통합 형식으로 변환합니다.

구체적으로는 다음과 같습니다.

• Telegram stickers → 표준화된 이미지 첨부 파일
• Discord embeds → 텍스트와 미디어의 조합으로 파싱
• WhatsApp reactions → 이모지 텍스트로 변환
• 음성 메시지 → 오디오 파일을 추출하고, 설정되어 있다면 텍스트로 변환

이 과정은 사용자에게 전혀 드러나지 않습니다. 어느 플랫폼에서든 메시지만 보내면 OpenClaw가 자동으로 형식을 변환합니다.

Gateway Server: 메시지의 교통 허브

정규화된 메시지는 Gateway Server로 들어갑니다. OpenClaw의 핵심 두뇌인 Gateway Server는 세 가지 작업을 담당합니다.

1. Session Router(세션 라우터): 메시지가 어느 세션으로 들어가야 하는지 판단합니다. 개인 DM인지, 팀 그룹인지, 아니면 다른 플랫폼과 공유하는 동일한 대화인지 구분합니다.
2. Lane Queue(레인 큐): 동시 실행을 제어합니다. 세 플랫폼에서 동시에 메시지를 보내도 Lane Queue가 충돌을 막고 순서대로 처리합니다.
3. 메시지 전달: AI의 응답을 올바른 플랫폼의 올바른 사용자에게 돌려보냅니다.

솔직히 Session Router 설정을 처음 봤을 때는 per-channel-peer, per-account-channel-peer 같은 항목이 다소 헷갈렸습니다. 뒤에서 이 전략들을 자세히 설명하겠지만, 우선 Gateway를 사용하면 WhatsApp에서 시작한 대화를 Telegram에서 자연스럽게 이어갈 수 있다는 점만 기억해 두세요.

13개 플랫폼 중 무엇을 사용할까요?

현재 OpenClaw가 지원하는 플랫폼은 다음과 같습니다.

• 인스턴트 메시징: WhatsApp, Telegram, Signal, iMessage(BlueBubbles 사용)
• 팀 협업: Slack, Microsoft Teams, Google Chat, Discord
• 기타: Matrix, Zalo, Twitch, WebChat

저는 Telegram(개인) + WhatsApp(가족과 친구) + Discord(기술 커뮤니티) 조합을 사용합니다. 각자의 용도에 맞게 선택하면 됩니다.

주요 플랫폼 3개 설정 실전: 15분 만에 끝내기

이론은 충분히 살펴봤으니 이제 직접 설정해 보겠습니다.

설치 및 초기화

터미널을 열고 다음 두 명령을 실행합니다.

npm install -g openclaw@latest
openclaw onboard --install-daemon

onboard는 몇 가지 항목을 묻습니다.

1. AI 제공업체 선택: Claude, GPT, Gemini 또는 로컬 모델 중 무엇을 사용할까요? 저는 익숙한 Claude를 선택했습니다.
2. API 키: 붙여 넣을 때 공백이나 따옴표가 포함되지 않도록 주의하세요.
3. Gateway 포트: 기본값 18789를 그대로 사용합니다.

몇 분 후 다음 메시지를 확인할 수 있습니다.

✓ Gateway WebSocket server started on ws://127.0.0.1:18789
✓ Control UI available at http://localhost:18789

이제 OpenClaw가 컴퓨터에서 실행됩니다.

보안 안내: Control UI는 기본적으로 localhost에서만 접근할 수 있습니다. 원격 서버에서 실행한다면 SSH 터널을 사용하세요.

Railway - 현대적인 배포 플랫폼, 번거로운 운영 없이 몇 분 만에 라이브

지금 시작 →광고

ssh -N -L 18789:127.0.0.1:18789 your-server

Telegram 설정: 가장 쉬운 시작 방법

설정이 가장 빠른 Telegram부터 시작하겠습니다.

1. Bot 생성:

   • Telegram에서 @BotFather 검색
   • /newbot 전송
   • Bot 이름 지정(예: ‘나의 OpenClaw 어시스턴트’)
   • 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz와 같은 Token 발급

2. OpenClaw 설정:

   openclaw config set telegram.token "YOUR_BOT_TOKEN"

   YOUR_BOT_TOKEN을 방금 발급받은 실제 Token으로 바꿉니다.

3. 확인:

   • Telegram에서 Bot 이름 검색
   • /start 전송
   • Bot이 응답하면 성공

처음 설정했을 때 제 Bot은 응답하지 않았습니다. 나중에 확인해 보니 Token을 복사하면서 줄바꿈 문자까지 포함된 것이 원인이었습니다. 따라서 Token 앞뒤에 불필요한 문자가 없는지 반드시 확인하세요.

WhatsApp 설정: QR 코드로 페어링하기

WhatsApp은 휴대전화 페어링 방식을 사용하므로 조금 더 복잡합니다.

1. 페어링 시작:

   openclaw config set whatsapp.enabled true
   openclaw gateway restart

2. QR 코드 스캔:

   • 터미널에 QR 코드가 표시됩니다.
   • WhatsApp → 설정 → 연결된 기기 → 기기 연결로 이동합니다.
   • 터미널의 QR 코드를 스캔합니다.

3. 연결 대기:
   WhatsApp connected가 표시되면 성공입니다.

주의 사항:

• OpenClaw가 메시지를 주고받으려면 휴대전화와 컴퓨터가 모두 온라인 상태여야 합니다. 이는 WhatsApp의 제한입니다.
• QR 코드가 만료되면 openclaw gateway restart를 다시 실행합니다.
• OpenClaw는 Baileys 라이브러리를 사용하며 WhatsApp Web 프로토콜을 따릅니다. 현재 공식적으로 차단되지는 않았지만 정책이 바뀔 수 있으므로 위험은 직접 판단해야 합니다.

처음에는 WhatsApp 계정이 정지되지 않을까 걱정했습니다. 하지만 원리가 WhatsApp Web과 같기 때문에 스팸 메시지를 대량으로 보내지 않고 정상적으로 사용한다면 문제가 없었습니다.

Discord 설정: 권한이 핵심입니다

Discord에서는 Developer Portal에서 애플리케이션을 생성해야 하므로 단계가 조금 더 많습니다.

1. 애플리케이션 생성:

   • https://discord.com/developers/applications 접속
   • New Application을 클릭하고 이름 지정
   • Bot 페이지에서 Add Bot 클릭
   • Token 복사

2. 권한 설정:
   이 단계가 매우 중요합니다. 권한이 부족하면 Bot이 메시지를 받을 수 없습니다.

   • OAuth2 → URL Generator로 이동
   • Scopes에서 bot 선택
   • Bot Permissions에서 다음 항목 선택:
     • Read Messages/View Channels
     • Send Messages
     • Read Message History
     • Attach Files
   • 생성된 URL을 복사해 브라우저에서 열고 Bot을 서버에 초대

3. OpenClaw 설정:

   openclaw config set discord.token "YOUR_DISCORD_BOT_TOKEN"
   openclaw config set discord.guildId "YOUR_SERVER_ID"

   Guild ID를 확인하는 방법은 다음과 같습니다.

   • Discord에서 개발자 모드를 켭니다(설정 → 고급 → 개발자 모드).
   • 서버 아이콘을 마우스 오른쪽 버튼으로 클릭한 뒤 ID 복사를 선택합니다.

4. 테스트:

   • Discord의 아무 채널에서나 Bot을 @멘션합니다.
   • 메시지를 보내고 Bot이 응답하는지 확인합니다.

처음 Discord를 설정했을 때 Bot이 계속 응답하지 않았습니다. 한참 확인한 끝에 Read Message History 권한을 선택하지 않은 것이 원인임을 찾았습니다. 따라서 권한 설정 단계를 절대 건너뛰지 마세요.

세션 관리의 핵심: 모든 플랫폼에서 AI가 나를 기억하게 하기

세 플랫폼을 모두 설정하고 나면 또 하나의 질문이 생깁니다. Telegram에서 AI와 대화한 뒤 Discord로 전환했을 때 AI는 두 사용자가 같은 사람이라는 것을 어떻게 알까요?

이 역할을 Session Router가 담당합니다.

Main 세션과 격리 세션

OpenClaw의 기본 전략은 모든 DM(개인 메시지)을 하나의 main 세션에 넣는 것입니다.

즉 Telegram, WhatsApp, Discord에서 각각 AI에게 DM을 보내도 모두 같은 대화 기록을 공유합니다. AI는 어느 플랫폼에서 말한 내용이든 기억할 수 있습니다.

하지만 팀에 OpenClaw를 배포해 여러 동료가 함께 사용한다면 이 방식은 적합하지 않습니다. 모두의 메시지가 한데 섞이기 때문입니다. 이때는 격리 전략이 필요합니다.

openclaw config set session.dmScope "per-channel-peer"

이 설정은 각 플랫폼의 사용자마다 독립된 세션을 부여한다는 뜻입니다.

더 세밀하게 격리할 수도 있습니다.

openclaw config set session.dmScope "per-account-channel-peer"

이 설정은 여러 OpenClaw 계정을 관리할 때 적합합니다.

저는 개인 용도로 사용하므로 기본 main 세션을 유지합니다. 제가 원하는 기능 자체가 모든 플랫폼에서 AI가 저를 기억하는 것이기 때문입니다.

크로스 플랫폼 신원 연결

때로는 OpenClaw가 ‘Telegram의 @username과 WhatsApp의 +86xxx는 같은 사람’이라는 사실을 명확히 알게 하고 싶을 수 있습니다.

session.identityLinks를 설정하세요.

session:
  identityLinks:
    - platforms:
        telegram: "@your_username"
        whatsapp: "+8613800138000"
        discord: "123456789012345678"  # Discord User ID

이렇게 설정하면 어느 플랫폼에서 메시지를 보내든 OpenClaw가 같은 사용자라는 것을 알고 동일한 세션을 이어갑니다.

자주 쓰는 세션 명령

AI와 대화를 너무 오래 해 새로 시작하고 싶거나 현재 어떤 모델을 사용하는지 확인하고 싶다면 다음 명령이 유용합니다.

• /status - 현재 모델, token 사용량, 세션 지속 시간 확인
• /new - 세션을 초기화하고 기록 삭제
• /activation mention - 그룹에서 @멘션할 때만 응답하도록 설정
• /activation always - 그룹의 모든 메시지에 응답하도록 설정. 지나치게 시끄러울 수 있으므로 주의하세요.

Control UI의 Sessions 페이지에서 사용할 수 있는 도구 명령도 있습니다.

• sessions_list - 모든 활성 세션 나열
• sessions_history - 대화 기록 내보내기
• sessions_send - 특정 세션에 직접 메시지 보내기

솔직히 저는 /new를 가장 자주 사용합니다. AI가 맥락을 잘못 이해했을 때는 하나씩 바로잡는 것보다 초기화하는 편이 더 빠를 때가 있습니다.

보안 설정: 낯선 사용자가 내 AI를 공짜로 쓰지 못하게 하기

설정을 마치고 신나게 며칠 동안 사용했는데 갑자기 API 비용이 급증했습니다. 로그를 확인해 보니 낯선 사용자가 제 Bot을 계속 호출하고 있었습니다.

이 일을 계기로 OpenClaw의 보안 전략을 자세히 살펴봤습니다.

DM 페어링 정책: 기본 보호 장치

OpenClaw의 기본 dmPolicy는 pairing(페어링 모드)입니다.

낯선 사용자가 처음 Bot에 DM을 보내면 Bot은 응답하는 대신 로그에 6자리 페어링 코드를 생성합니다. 다음 명령으로 직접 승인해야 합니다.

openclaw pairing approve telegram ABC123

페어링 코드는 1시간 후 만료되어 무차별 대입 공격을 막습니다. 승인된 사용자는 이후부터 정상적으로 사용할 수 있습니다.

Alibaba Cloud - 개발자 클라우드 1순위, Lighthouse 서버 15% 할인

15% 할인 받기 →광고

처음에는 이 방식이 조금 번거롭다고 생각했습니다. 하지만 이 보호 장치가 없으면 누구든 Bot 사용자 이름만 알아내 API를 무제한 호출하고 제 비용을 소모할 수 있다는 사실을 곧 이해했습니다.

네 가지 DM 정책 중 무엇을 선택해야 할까요?

OpenClaw는 네 가지 정책을 제공합니다.

커뮤니티용 공개 Bot을 만들고 싶다면 open 모드를 사용할 수 있지만, token 사용량 모니터링을 반드시 함께 설정하는 것이 좋습니다. 무분별한 호출을 막기 위해서입니다.

설정 방법은 다음과 같습니다.

openclaw config set dmPolicy "allowlist"
openclaw config set dmAllowlist "telegram:@friend1,whatsapp:+8613800138000"

그룹 샌드박스 격리: 악성 명령 차단하기

OpenClaw의 AI agent는 bash 명령이나 파일 작업 같은 도구를 실행할 수 있습니다. 누군가 그룹에서 AI에게 rm -rf /를 실행하라고 한다면 어떻게 될까요?

그룹 샌드박스 전략은 바로 이런 상황을 막기 위해 마련되었습니다.

openclaw config set agents.defaults.sandbox.mode "non-main"

이 설정은 그룹 같은 non-main 세션의 AI를 Docker 샌드박스에서 실행해 호스트 파일 시스템에 접근하지 못하게 합니다.

허용하거나 금지할 도구도 직접 설정할 수 있습니다.

agents:
  defaults:
    sandbox:
      mode: "non-main"
      allowedTools:
        - web_search
        - calculator
      deniedTools:
        - bash
        - file_write

저는 그룹에서 검색과 계산기만 허용하고 bash와 파일 작업은 금지했습니다. 기능은 유지하면서 위험을 통제할 수 있습니다.

Mention 게이트: 항상 끼어드는 AI 피하기

AI를 Discord 서버에 초대했는데 모든 메시지에 응답한다면 매우 시끄러울 것입니다.

activation: mention 전략을 사용하면 @멘션할 때만 AI가 응답합니다.

openclaw config set agents.defaults.activation "mention"

이렇게 설정하면 AI는 조용히 대기하다가 필요할 때 @멘션하면 응답합니다.

보안 점검 목록:

openclaw doctor

이 명령은 설정을 검사하고 잠재적 위험을 표시합니다.

• ✗ dmPolicy: open without rate limiting
• ✗ sandbox.mode: disabled in group sessions
• ✓ API key properly configured
• ✓ DM pairing enabled

doctor를 한 번 실행하면 많은 보안 문제를 미리 피할 수 있습니다.

직접 겪은 문제와 해결 방법

설정 과정에서 문제를 마주치는 것은 피하기 어렵습니다. 제가 직접 겪은 몇 가지 문제를 소개합니다.

문제 1: API 키 오류

증상: Bot은 정상적으로 시작되지만 메시지에 응답하지 않고 로그에 Invalid API key가 표시됩니다.

원인:

1. API 키를 복사할 때 공백이나 따옴표가 함께 들어갔습니다.
2. 환경 변수가 적용되지 않았습니다. 터미널을 다시 시작해 보세요.
3. API 계정에 결제 수단이 등록되지 않았습니다. Claude와 GPT 모두 결제 수단이 필요합니다.

해결 방법:

# 불필요한 문자가 없도록 다시 설정
openclaw config set anthropic.apiKey "sk-ant-..."

# 설정 적용 여부 확인
openclaw config get anthropic.apiKey

# Gateway 재시작
openclaw gateway restart

문제 2: 포트 충돌

증상: openclaw gateway start를 실행하면 Port 18789 already in use 오류가 발생합니다.

원인: 이전 Gateway 프로세스가 종료되지 않았습니다.

해결 방법:

# 정상 종료
openclaw gateway stop

# 그래도 해결되지 않으면 프로세스 강제 종료
pkill -f openclaw-gateway

# 다시 시작
openclaw gateway start

문제 3: Control UI 접속 오류

증상: 브라우저에서 http://localhost:18789를 열면 control ui requires HTTPS or localhost가 표시됩니다.

원인: 원격 서버에서 localhost 대신 서버 IP를 사용하고 있을 수 있습니다.

KiloClaw - 기업용 매니지드 OpenClaw, AI Agent 오케스트레이션 및 스마트 라우팅

시작하기 →광고

해결 방법 1: token 파라미터 사용

http://your-server-ip:18789?token=YOUR_TOKEN

Token은 ~/.openclaw/gateway.env 파일에 있습니다.

해결 방법 2: SSH 터널 사용

ssh -N -L 18789:127.0.0.1:18789 user@your-server

그런 다음 로컬에서 http://localhost:18789에 접속합니다.

문제 4: Channel 연결 실패

Telegram:

• Token 유효성 확인: BotFather에서 Bot이 아직 존재하는지 확인합니다.
• 네트워크 문제: 일부 지역에서는 Telegram API에 연결하기 위해 프록시가 필요합니다.

WhatsApp:

• QR 코드 만료: openclaw gateway restart를 다시 실행합니다.
• 휴대전화 오프라인: WhatsApp에서 메시지를 동기화하려면 휴대전화가 온라인 상태여야 합니다.
• 다중 기기 제한: WhatsApp은 연결된 기기를 최대 4대까지 지원합니다.

Discord:

• Bot 권한 부족: Read Message History 권한을 확인합니다.
• 잘못된 Guild ID: 올바른 서버 ID를 복사했는지 확인합니다.
• Bot이 서버에 없음: OAuth2 URL로 Bot을 다시 초대합니다.

문제 5: 세션 기록 손실

증상: Gateway를 재시작한 뒤 이전 대화 기록이 모두 사라집니다.

원인: 현재 OpenClaw에는 2026년 초 기준으로 세션 영속성 기능이 없습니다. Gateway를 재시작하면 메모리의 세션이 삭제됩니다.

대응 방법:

• 중요한 대화는 sessions_history로 내보내 저장합니다.
• 공식 후속 버전의 세션 영속성 지원을 기다립니다. 이 기능은 Roadmap에 포함되어 있습니다.

솔직히 제가 가장 개선되기를 바라는 부분입니다. OpenClaw를 업데이트할 때마다 AI에게 저를 다시 소개해야 해서 조금 번거롭습니다.

마무리

2주 동안 OpenClaw를 사용하면서 가장 크게 느낀 점은 AI를 진정한 크로스 플랫폼 ‘통합 어시스턴트’로 만들 수 있다는 것입니다.

아침에는 WhatsApp에서 AI에게 일정을 정리하게 하고, 회사에서는 Slack에서 대화를 이어가며, 저녁에는 Discord에서 팀과 협업해도 모든 대화가 자연스럽게 연결됩니다. 단일 플랫폼 Bot으로는 구현하기 어려운 경험입니다.

Channel 계층 구조의 설계는 매우 영리합니다. 13개 플랫폼의 메시지를 정규화하고, Session Router로 세션을 관리하며, 세밀한 보안 제어까지 더해 시스템 전체가 유연하면서도 안전합니다.

물론 OpenClaw는 여전히 빠르게 발전하고 있습니다. 세션 영속성, Skills 마켓, 더 많은 플랫폼 지원이 공식 Roadmap에 포함되어 있어 후속 버전도 기대됩니다.

직접 사용해 보고 싶다면 다음 명령을 실행하세요.

curl -fsSL https://openclaw.ai/install.sh | bash

15분만 설정하면 곧바로 크로스 플랫폼 AI 어시스턴트를 경험할 수 있습니다.

설정 중 문제가 생기면 GitHub Discussions에 질문해 보세요. 커뮤니티의 응답이 빠른 편입니다. 저도 Telegram 연결 문제를 올렸을 때 10분 만에 도움을 받았습니다.

OpenClaw를 사용하고 계신가요? 어떤 플랫폼을 설정했고 어떤 문제를 겪었는지 댓글로 공유해 주세요.