Technical reference
Zengin çıktı protokolü
Asistan çıktısı küçük bir teslim/işleme yönergeleri kümesi taşıyabilir:
- Ek teslimi için
MEDIA: - Ses sunumu ipuçları için
[[audio_as_voice]] - Yanıt metaverileri için
[[reply_to_current]]/[[reply_to:<id>]] - Control UI zengin işlemesi için
[embed ...]
Uzak MEDIA: ekleri herkese açık https: URL'leri olmalıdır. Düz http:,
loopback, link-local, özel ve dahili ana makine adları ek yönergeleri olarak
yok sayılır; sunucu tarafı medya getiricileri yine de kendi ağ korumalarını
uygular.
Yerel MEDIA: ekleri mutlak yolları, çalışma alanına göreli yolları veya
ana dizine göreli ~/ yollarını kullanabilir. Teslimden önce yine de ajan
dosya okuma ilkesinden ve medya türü denetimlerinden geçerler.
Düz Markdown görsel sözdizimi varsayılan olarak metin kalır. Markdown görsel
yanıtlarını kasıtlı olarak medya eklerine eşleyen kanallar, bunu giden
adaptörlerinde etkinleştirir; Telegram bunu yapar, böylece  yine de
bir medya yanıtına dönüşebilir.
Bu yönergeler ayrıdır. MEDIA: ve yanıt/ses etiketleri teslim metaverisi olarak kalır; [embed ...] yalnızca web'e özgü zengin işleme yoludur.
Güvenilir araç sonucu medyası, teslimden önce aynı MEDIA: / [[audio_as_voice]] ayrıştırıcısını kullanır; böylece metin araç çıktıları yine de bir ses ekini sesli not olarak işaretleyebilir.
Blok akışı etkin olduğunda, MEDIA: bir tur için tek teslimlik metaveri olarak
kalır. Aynı medya URL'si akışla gönderilen bir blokta gönderilir ve son
asistan yükünde yinelenirse, OpenClaw eki bir kez teslim eder ve kopyayı son
yükten çıkarır.
[embed ...]
[embed ...], Control UI için ajana dönük tek zengin işleme sözdizimidir.
Kendi kendini kapatan örnek:
[embed ref="cv_123" title="Status" /]
Kurallar:
[view ...]artık yeni çıktı için 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çimli satır içi HTML embed kısa kodları işlenmez.
- Web kullanıcı arayüzü kısa kodu görünür metinden çıkarır ve embed'i satır içinde işler.
MEDIA:bir embed takma adı değildir ve zengin embed işleme için kullanılmamalıdır.
Saklanan işleme yapısı
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 yapısını doğrudan kullanır. present_view tanınmaz.