Nodes and media

Görsel ve medya desteği

WhatsApp kanalı Baileys Web üzerinden çalışır. Bu belge, gönderim, Gateway ve aracı yanıtları için geçerli medya işleme kurallarını kaydeder.

Hedefler

openclaw message send --media ile isteğe bağlı başlıklar eşliğinde medya gönderin.
Web gelen kutusundan otomatik yanıtların metnin yanında medya da içermesine izin verin.
Tür başına sınırları makul ve öngörülebilir tutun.

openclaw message send --media <path-or-url> [--message <caption>]
- --media isteğe bağlıdır; yalnızca medya gönderimleri için başlık boş olabilir.
- --dry-run çözümlenmiş yükü yazdırır; --json, { channel, to, messageId, mediaUrl, caption } üretir.

Girdi: yerel dosya yolu veya HTTP(S) URL'si.
Akış: bir Buffer içine yükleyin, medya türünü algılayın ve doğru yükü oluşturun:
- Görüntüler: channels.whatsapp.mediaMaxMb hedeflenerek (varsayılan: 50 MB) JPEG olarak yeniden boyutlandırılır ve yeniden sıkıştırılır (maksimum kenar 2048px).
- Ses/Sesli/Video: 16 MB'a kadar doğrudan geçirilir; ses, sesli not olarak gönderilir (ptt: true).
- Belgeler: diğer her şey, mümkün olduğunda dosya adı korunarak 100 MB'a kadar.
WhatsApp GIF tarzı oynatma: mobil istemcilerin satır içinde döngüye alması için gifPlayback: true ile bir MP4 gönderin (CLI: --gif-playback).
MIME algılama önce sihirli baytları, sonra başlıkları, ardından dosya uzantısını tercih eder.
Başlık --message veya reply.text içinden gelir; boş başlığa izin verilir.
Günlükleme: ayrıntısız mod ↩️/✅ gösterir; ayrıntılı mod boyutu ve kaynak yolunu/URL'sini içerir.

getReplyFromConfig, { text?, mediaUrl?, mediaUrls? } döndürür.
Medya mevcut olduğunda web göndericisi, yerel yolları veya URL'leri openclaw message send ile aynı iş hattını kullanarak çözümler.
Sağlanırsa birden çok medya girdisi sırayla gönderilir.

Gelen web iletileri medya içerdiğinde OpenClaw geçici bir dosyaya indirir ve şablonlama değişkenlerini sunar:
- Gelen medya için {{MediaUrl}} sözde URL'si.
- Komutu çalıştırmadan önce yazılan yerel geçici yol {{MediaPath}}.
Oturum başına Docker sandbox etkinleştirildiğinde, gelen medya sandbox çalışma alanına kopyalanır ve MediaPath/MediaUrl, media/inbound/<filename> gibi göreli bir yola yeniden yazılır.
Medya anlama (tools.media.* veya paylaşılan tools.media.models üzerinden yapılandırıldıysa) şablonlamadan önce çalışır ve Body içine [Image], [Audio] ve [Video] blokları ekleyebilir.
- Ses, {{Transcript}} değerini ayarlar ve komut ayrıştırma için transkripti kullanır; böylece eğik çizgi komutları çalışmaya devam eder.
- Video ve görüntü açıklamaları, komut ayrıştırma için varsa başlık metnini korur.
- Etkin birincil görüntü modeli zaten yerel olarak görmeyi destekliyorsa OpenClaw [Image] özet bloğunu atlar ve bunun yerine özgün görüntüyü modele geçirir.
Varsayılan olarak yalnızca ilk eşleşen görüntü/ses/video eki işlenir; birden çok eki işlemek için tools.media.<cap>.attachments ayarını belirleyin.

Giden gönderim üst sınırları (WhatsApp web gönderimi)

Görüntüler: yeniden sıkıştırmadan sonra channels.whatsapp.mediaMaxMb değerine kadar (varsayılan: 50 MB).
Ses/sesli/video: 16 MB üst sınırı; belgeler: 100 MB üst sınırı.
Fazla büyük veya okunamayan medya → günlüklerde açık hata ve yanıt atlanır.

Medya anlama üst sınırları (transkripsiyon/açıklama)

Görüntü/ses/belge durumları için gönderim + yanıt akışlarını kapsayın.
Görüntüler için yeniden sıkıştırmayı (boyut sınırı) ve ses için sesli not bayrağını doğrulayın.
Çoklu medya yanıtlarının ardışık gönderimler olarak yayıldığından emin olun.