OpenClaw 미디어 및 파일 전송 가이드: 이미지와 PDF 활용법

챗봇을 개발할 때 이미지나 PDF 같은 미디어 파일을 다루는 일은 생각보다 까다롭습니다. 파일 경로를 맞추는 것부터 시작해서 각 채널마다 다른 업로드 방식을 대응하다 보면 금방 지치기 마련이죠. OpenClaw를 사용하면 이런 복잡한 미디어 처리 과정을 훨씬 간단하게 구현할 수 있습니다.

Media & Attachments

OpenClaw에서 이미지, 파일, 미디어를 다루는 방법을 알아봅니다.

OpenClaw로 이미지와 PDF를 보낼 수 있나요?

네, 가능해요. 워크스페이스에 파일을 두거나 전체 경로를 입력한 뒤, 봇에게 보내달라고 요청해 보세요. OpenClaw가 상황에 맞춰 적절한 채널 방식(inline, upload, 또는 hosted link)을 선택해서 전송해 줍니다.

예시:

Send /docs/invoice.pdf to the chat

OpenClaw는 들어오는 이미지를 어떻게 처리하나요?

OpenClaw는 Claude, GPT-4o, Gemini 같은 vision 모델을 사용해서 들어오는 이미지를 처리해요. 모델이 지원하는 경우 이미지는 해당 모델의 multimodal API로 전달됩니다.

만약 vision 기능을 사용할 수 없는 환경이라면, 설정에 따라 이미지를 설명하거나 OCR로 텍스트를 추출하고, 혹은 그냥 건너뛸 수도 있어요.

Skill에서 이미지나 파일을 보낼 수 있나요?

네, 당연하죠. Skill에서 fs_write와 media_send 같은 tool wrapper를 조합해서 사용하거나, 에이전트에게 파일을 보내달라고 직접 요청하면 돼요.

Please send the chart at /workspace/output/chart.png

어떤 이미지 포맷을 지원하나요?

PNG, JPEG, GIF, WebP, HEIC 같은 대부분의 일반적인 포맷을 지원해요. 문서 기반 워크플로우를 위해 PDF도 지원하고 있습니다.

실제 지원 여부는 사용하는 모델과 채널에 따라 달라질 수 있어요. Claude와 GPT-4o는 대부분의 이미지 타입을 잘 처리하지만, 일부 채널에서는 업로드 전에 이미지를 변환하거나 압축하기도 해요.

파일 크기 제한이 있나요?

각 채널마다 정해진 제한이 적용돼요.

WhatsApp: 약 16MB (압축 시)
Telegram: 파일은 약 50MB, 사진은 약 10MB
Slack: 워크스페이스 티어에 따라 다름
Discord: 약 25MB (Nitro 사용 시 100MB)

파일 용량이 너무 크다면 직접 파일을 올리는 대신 hosted link를 사용하는 게 좋아요.

다음 단계

AI Setup Assistant

OpenClaw Expert

아직 막혀 있나요?

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