WhatsApp 미디어 및 이미지 지원 가이드

메신저 봇을 개발할 때 가장 번거로운 작업 중 하나가 바로 미디어 처리예요. 로컬 파일을 업로드하거나 외부 URL을 처리하고, 각 플랫폼의 용량 제한에 맞춰 이미지를 일일이 압축하는 과정은 생각보다 까다롭고 손이 많이 가죠.

OpenClaw는 Baileys Web을 통해 이러한 과정을 자동화해요. 개발자가 복잡한 인코딩이나 MIME 타입을 직접 관리하지 않아도 미디어를 안정적으로 주고받을 수 있는 환경을 제공합니다.

필요한 것

CLI를 사용하면 5분 안에 미디어를 전송할 수 있어요. 로컬 경로와 HTTP(S) URL을 모두 지원합니다.

기본 미디어 전송 --media 플래그를 사용해 파일이나 URL을 지정하세요. 캡션은 선택 사항이에요.
Terminal window
```
openclaw message send --media "./images/photo.jpg" --message "사진 설명입니다"
```
결과 미리보기 및 JSON 출력 실제로 전송하기 전에 페이로드를 확인하거나 프로그래밍 방식으로 결과를 처리할 수 있어요.
Terminal window
```
# 페이로드 확인
openclaw message send --media "https://example.com/video.mp4" --dry-run

# JSON 결과 출력
openclaw message send --media "./doc.pdf" --json
```
GIF 스타일 재생 비디오를 모바일 클라이언트에서 반복 재생되는 GIF처럼 보내려면 --gif-playback 플래그를 추가하세요.
Terminal window
```
openclaw message send --media "./animation.mp4" --gif-playback
```
자동 답장 설정 설정 파일의 getReplyFromConfig를 통해 여러 미디어를 순차적으로 보낼 수도 있어요.
```
{
  "text": "요청하신 자료입니다",
  "mediaUrls": ["./file1.pdf", "./file2.pdf"]
}
```

미디어 전송이나 분석 중 문제가 발생하면 다음 사항을 확인해 보세요.

미디어 크기 초과: 이미지(6MB), 오디오/비디오(16MB), 문서(100MB) 제한을 넘으면 로그에 오류가 기록되고 전송이 취소돼요.
읽을 수 없는 파일: 파일 경로가 잘못되었거나 URL 접근이 불가능한 경우 로그에서 확인 가능하며 해당 답장은 건너뜁니다.
분석(Understanding) 실패: tools.media에 설정된 용량 제한(이미지 10MB, 오디오 20MB, 비디오 50MB)을 초과하면 분석 단계만 생략되고 원본 메시지는 그대로 전달돼요.
MIME 타입 감지: 파일 확장자보다 실제 데이터(Magic Bytes)를 우선해서 감지하므로, 확장자가 잘못되어도 데이터가 올바르면 처리가 가능해요.

OpenClaw Expert

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.