Nodes and media

Görsel ve medya desteği

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

Hedefler

openclaw message send --media ile isteğe bağlı altyazılarla medya gönderin.
Web gelen kutusundan otomatik yanıtların metnin yanında medya 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 altyazı boş olabilir.
- --dry-run çözümlenen 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 (en uzun kenar 2048 px).
- Ses/Sesli mesaj/Video: 16 MB'a kadar doğrudan geçirilir; ses, sesli not olarak gönderilir (ptt: true).
- Belgeler: diğer her şey, mevcut 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 magic byte'ları, ardından başlıkları, ardından dosya uzantısını tercih eder.
Altyazı --message veya reply.text içinden gelir; boş altyazıya izin verilir.
Günlükleme: ayrıntısız mod ↩️/✅ gösterir; ayrıntılı mod boyut ve kaynak yolu/URL'sini içerir.

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

Gelen web mesajları medya içerdiğinde, OpenClaw geçici bir dosyaya indirir ve şablon 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 korumalı alanı etkinleştirildiğinde, gelen medya korumalı alan ç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 aracılığıyla 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 eğik çizgi komutlarının çalışmaya devam etmesi için komut ayrıştırmada dökümü kullanır.
- Video ve görüntü açıklamaları, komut ayrıştırma için varsa altyazı metnini korur.
- Etkin birincil görüntü modeli zaten doğal 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 eşleşen ilk görüntü/ses/video eki işlenir; birden fazla eki işlemek için tools.media.<cap>.attachments ayarlayın.

Giden gönderim 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 mesaj/video: 16 MB sınırı; belgeler: 100 MB sınırı.
Aşırı büyük veya okunamayan medya → günlüklerde açık hata ve yanıt atlanır.

Medya anlama sınırları (döküm/açıklama)

Görüntü varsayılanı: 10 MB (tools.media.image.maxBytes).
Ses varsayılanı: 20 MB (tools.media.audio.maxBytes).
Video varsayılanı: 50 MB (tools.media.video.maxBytes).
Aşırı büyük medya anlamayı atlar, ancak yanıtlar özgün gövdeyle yine de ilerler.

Görüntü/ses/belge durumları için gönderme + 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.
Çok medyalı yanıtların sırayla gönderimler olarak yayıldığından emin olun.

Was this useful?