Nodes and media

이미지 및 미디어 지원

WhatsApp 채널은 Baileys Web을 통해 실행됩니다. 이 문서는 전송, Gateway, 에이전트 응답에 대한 현재 미디어 처리 규칙을 설명합니다.

목표

openclaw message send --media <path-or-url> [--message <caption>]
- --media는 선택 사항이며, 미디어만 전송할 때 캡션은 비워둘 수 있습니다.
- --dry-run은 확인된 페이로드를 출력하고, --json은 { channel, to, messageId, mediaUrl, caption }을 내보냅니다.

입력: 로컬 파일 경로 또는 HTTP(S) URL.
흐름: Buffer로 로드하고, 미디어 종류를 감지한 뒤, 올바른 페이로드를 빌드합니다.
- 이미지: channels.whatsapp.mediaMaxMb(기본값: 50 MB)를 목표로 JPEG로 크기 조정 및 재압축(최대 변 2048px).
- 오디오/음성/비디오: 최대 16 MB까지 그대로 전달하며, 오디오는 음성 메모(ptt: true)로 전송됩니다.
- 문서: 그 외 모든 항목은 최대 100 MB까지 지원하며, 가능한 경우 파일 이름을 보존합니다.
WhatsApp GIF 스타일 재생: 모바일 클라이언트에서 인라인으로 반복 재생되도록 MP4를 gifPlayback: true(CLI: --gif-playback)와 함께 전송합니다.
MIME 감지는 매직 바이트, 헤더, 파일 확장자 순으로 우선합니다.
캡션은 --message 또는 reply.text에서 가져오며, 빈 캡션도 허용됩니다.
로깅: 비상세 모드는 ↩️/✅를 표시하고, 상세 모드는 크기와 소스 경로/URL을 포함합니다.

인바운드 웹 메시지에 미디어가 포함된 경우 OpenClaw는 임시 파일로 다운로드하고 템플릿 변수를 노출합니다.
- 인바운드 미디어용 {{MediaUrl}} 의사 URL.
- 명령 실행 전에 작성되는 {{MediaPath}} 로컬 임시 경로.
세션별 Docker 샌드박스가 활성화된 경우 인바운드 미디어는 샌드박스 워크스페이스로 복사되고, MediaPath/MediaUrl은 media/inbound/<filename> 같은 상대 경로로 다시 작성됩니다.
미디어 이해가 tools.media.* 또는 공유 tools.media.models를 통해 구성된 경우 템플릿 처리 전에 실행되며, [Image], [Audio], [Video] 블록을 Body에 삽입할 수 있습니다.
- 오디오는 {{Transcript}}를 설정하고 명령 파싱에 전사문을 사용하므로 슬래시 명령도 계속 작동합니다.
- 비디오 및 이미지 설명은 명령 파싱을 위해 모든 캡션 텍스트를 보존합니다.
- 활성 기본 이미지 모델이 이미 기본적으로 비전을 지원하는 경우 OpenClaw는 [Image] 요약 블록을 건너뛰고 대신 원본 이미지를 모델에 전달합니다.
기본적으로 일치하는 첫 번째 이미지/오디오/비디오 첨부 파일만 처리됩니다. 여러 첨부 파일을 처리하려면 tools.media.<cap>.attachments를 설정하세요.

아웃바운드 전송 한도(WhatsApp web 전송)

미디어 이해 한도(전사/설명)