1. 멀티 플랫폼 연동이 필요한 이유
단일 채널(예: 위챗만)로는 전원이나 해외 협업을 커버하기 어렵습니다. Telegram은 분산 팀·해외 사용자에 적합하고, 钉钉·飛書는 많은 국내 기업에서 쓰입니다. OpenClaw는 공식 또는 커뮤니티 플러그인으로 이들을 연동할 수 있어, 한 번 배포로 여러 앱에서 트리거할 수 있습니다.
2. 사전 조건
OpenClaw가 로컬 또는 원격에서 안정적으로 동작해야 합니다(Node.js 22+, API Key 설정 완료). 멀티 플랫폼은 ‘채널’ 추가이며, 채널마다 해당 플랫폼의 Bot Token 또는 앱 자격 증명이 필요합니다. 각 플랫폼 관리 콘솔에서 앱 생성·Secret/Token 발급 권한을 준비해 두세요.
3. Telegram 연동 단계
1단계: Telegram에서 @BotFather를 열고 /newbot을 보낸 뒤 안내에 따라 이름을 정하고 Bot Token을 받습니다.
2단계: OpenClaw에 Telegram 채널을 설치합니다(예: openclaw plugins install @openclaw/channel-telegram 또는 현재 문서대로).
3단계: OpenClaw 설정에 Token을 넣습니다. 그룹 메시지를 받으려면 Bot을 그룹에 초대하고 권한을 부여합니다. 게이트웨이를 띄운 뒤 Bot에게 메시지를 보내 응답을 확인합니다.
4. 钉钉 연동 단계
1단계: 钉钉 오픈 플랫폼에서 기업 앱 또는 로봇을 만들고 AppKey, AppSecret을 받습니다. 로봇 콜백 URL을 설정합니다(공개망에서 접근 가능하거나 터널로 노출).
2단계: 커뮤니티 플러그인(예: @soimy/openclaw-channel-dingtalk) 또는 공식 钉钉 채널을 설치한 뒤 AppKey·AppSecret·콜백 URL을 설정합니다.
3단계: 钉钉의 Stream(WebSocket) 모드를 쓰면 공개 IP가 필요 없을 수 있습니다. 플러그인 문서에 따라 Stream을 켜고 인증을 완료한 뒤 钉钉 클라이언트에서 로봇을 @하여 테스트합니다.
5. 飛書 연동 단계
1단계: 飛書 오픈 플랫폼에서 앱을 만들고 ‘로봇’ 기능을 켠 뒤 App ID, App Secret을 받습니다. 이벤트 구독과 요청 URL(또는 OpenClaw 飛書 플러그인에 따라 WebSocket URL)을 설정합니다.
2단계: OpenClaw에 飛書 채널을 설치하고 자격 증명을 설정합니다. ‘메시지 수신’ 등 권한을 구독하고, 飛書에서 URL 검증을 요구하면 해당 절차를 완료합니다.
3단계: 飛書에서 로봇을 그룹에 넣거나 1:1 채팅을 허용한 뒤 메시지를 보내 OpenClaw 응답을 확인합니다.
6. 자주 나오는 문제와 대응 표
| 증상 | 가능한 원인 | 조치 |
|---|---|---|
| Telegram 봇 무응답 | Token 오류 또는 네트워크 불통 | Token 확인, api.telegram.org 접근 가능 여부 확인 |
| 钉钉 콜백 403 / 서명 실패 | AppSecret 오류 또는 시간 차이 | AppSecret 확인, 서버 시간 동기화 |
| 飛書 검증 실패 | URL이 challenge 등 반환 안 함 | 飛書 문서에 따라 challenge 등 반환 |
| 그룹 메시지 수신 안 됨 | 봇 미가입 또는 권한 부족 | 봇을 그룹에 초대하고 ‘그룹 메시지 수신’ 등 권한 부여 |
| 여러 채널 동시 사용 시 포트/리소스 충돌 | 한 프로세스에서 여러 채널 사용 | 채널별 포트 또는 WebSocket 경로가 겹치지 않게 하고, 필요 시 인스턴스 분리 |
7. 정리: 원격 Mac에서 OpenClaw 24/7 운영의 가치
멀티 플랫폼 연동 후 OpenClaw는 팀 전체의 단일 AI 창구가 됩니다. 로컬 PC나 소규모 VPS에서 돌리면 절전·네트워크·환경 변경으로 다운될 위험이 있습니다. 원격 Mac 노드에서는 Apple Silicon의 안정적인 연산 성능, Metal 가속, 24/7 가동을 얻을 수 있고 본인 PC를 점유하지 않습니다. 여러 채널을 안정적으로 돌리고 싶다면 MACGPU 원격 Mac을 렌탈해 표준화된 macOS 환경에 OpenClaw를 배포하면, 한 번 설정으로 여러 플랫폼에 대응할 수 있습니다.