> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## CLI Yüzeyi

* `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.

## WhatsApp Web kanal davranışı

* 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.

## Otomatik Yanıt İşlem Hattı

* `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 Medyadan Komutlara

* 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.

## Sınırlar ve hatalar

**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.

## Testler İçin Notlar

* 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.

## İlgili

* [Kamera yakalama](/tr/nodes/camera)
* [Medya anlama](/tr/nodes/media-understanding)
* [Ses ve sesli notlar](/tr/nodes/audio)