Technical reference
Zengin çıktı protokolü
Asistan çıktısı küçük bir teslimat/işleme direktifleri kümesi taşıyabilir:
- ek teslimatı için yapılandırılmış
mediaUrl/mediaUrlsalanları - ses sunumu ipuçları için
[[audio_as_voice]] - yanıt meta verileri için
[[reply_to_current]]/[[reply_to:<id>]] - Control UI zengin işlemesi için
[embed ...]
Uzak medya ekleri herkese açık https: URL'leri olmalıdır. Düz http:,
loopback, link-local, özel ve dahili ana makine adları ek direktifleri olarak
yok sayılır; sunucu tarafı medya getiricileri yine de kendi ağ korumalarını uygular.
Yerel medya ekleri mutlak yollar, çalışma alanına göreli yollar veya
ana dizine göreli ~/ yolları kullanabilir. Teslimattan önce yine de ajan dosya okuma
politikasından ve medya türü kontrollerinden geçerler.
Düz Markdown görsel sözdizimi varsayılan olarak metin kalır. Markdown görsel
yanıtlarını bilinçli olarak medya eklerine eşleyen kanallar bunu giden
bağdaştırıcılarında etkinleştirir; Telegram bunu yapar, böylece  yine de
bir medya yanıtına dönüşebilir.
Bu direktifler ayrıdır. Yapılandırılmış medya alanları ve yanıt/ses etiketleri
teslimat meta verileridir; [embed ...] yalnızca web'e özgü zengin işleme yoludur.
Blok akışı etkinleştirildiğinde, medya yapılandırılmış yük alanlarında taşınmalıdır. Aynı medya URL'si bir akış bloğunda gönderilir ve nihai asistan yükünde tekrarlanırsa, OpenClaw eki bir kez teslim eder ve kopyayı nihai yükten çıkarır.
[embed ...]
[embed ...], Control UI için ajanların kullanacağı tek zengin işleme sözdizimidir.
Kendi kendini kapatan örnek:
[embed ref="cv_123" title="Status" /]Kurallar:
[view ...]yeni çıktı için artık geçerli değildir.- Embed kısa kodları yalnızca asistan mesaj yüzeyinde işlenir.
- Yalnızca URL destekli embed'ler işlenir.
ref="..."veyaurl="..."kullanın. - Blok biçimindeki satır içi HTML embed kısa kodları işlenmez.
- Web UI, kısa kodu görünür metinden çıkarır ve embed'i satır içinde işler.
- Yapılandırılmış medya bir embed takma adı değildir ve zengin embed işlemesi için kullanılmamalıdır.
Saklanan işleme şekli
Normalleştirilmiş/saklanan asistan içerik bloğu yapılandırılmış bir canvas öğesidir:
{ "type": "canvas", "preview": { "kind": "canvas", "surface": "assistant_message", "render": "url", "viewId": "cv_123", "url": "/__openclaw__/canvas/documents/cv_123/index.html", "title": "Status", "preferredHeight": 320 }}Saklanan/işlenen zengin bloklar bu canvas şeklini doğrudan kullanır. present_view tanınmaz.
