Zengin çıktı protokolü

Asistan çıktısı, teslimat/işleme yönergelerini birkaç özel kanal üzerinden taşır:

Ek teslimatı için yapılandırılmış mediaUrl / mediaUrls alanları.
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 ...].

Yapılandırılmış medya alanları ve [[...]] etiketleri teslimat meta verileridir. [embed ...], yalnızca web’e yönelik ayrı zengin işleme yoludur; bir medya takma adı değildir.

Medya ekleri

Uzak ekler, herkese açık https: URL’leri olmalıdır. http:, geri döngü, bağlantı yerel, özel ve dahili ana bilgisayar adları ek yönergeleri olarak reddedilir; sunucu tarafındaki medya getiricileri bunlara ek olarak kendi ağ korumalarını uygular. Yerel ekler mutlak yolları, çalışma alanına göreli yolları veya ana dizine göreli ~/ yollarını kabul eder. Teslimattan önce yine de aracı dosya okuma politikasından ve medya türü kontrollerinden geçerler.

Araçlardan, Plugin’lerden, akış bloklarından, tarayıcı çıktısından veya mesaj eylemlerinden ekler için metin komutları yayınlamayın. Bunun yerine yapılandırılmış medya alanlarını kullanın:

{ "message": "İşte görseliniz.", "mediaUrl": "/workspace/image.png" }

Eski nihai yanıt metni uyumluluk amacıyla hâlâ normalleştirilebilir, ancak bu genel bir Plugin/araç protokolü değildir.

Düz Markdown görsel söz dizimi (![alt](url)) varsayılan olarak metin şeklinde kalır. Markdown görsellerini medya yanıtları olarak işlemek isteyen kanallar, giden bağdaştırıcılarında bunu etkinleştirir; Telegram bunu yaptığı için ![alt](url) bir medya ekine dönüşür. Blok akışı etkinleştirildiğinde medya, yapılandırılmış yük alanlarında taşınmalıdır. Aynı medya URL’si hem akışla gönderilen bir blokta hem de nihai asistan yükünde tekrar görünürse OpenClaw bunu bir kez teslim eder ve yinelenen öğeyi nihai yükten çıkarır.

`[embed ...]`

[embed ...], Control UI için aracıya yönelik tek zengin işleme söz dizimidir. Kendiliğinden kapanan örnek:

[embed ref="cv_123" title="Status" /]

Kurallar:

[view ...] artık yeni çıktılar için geçerli değildir.
Gömme kısa kodları yalnızca asistan mesajı yüzeyinde işlenir.
Yalnızca URL destekli gömmeler işlenir; ref="..." veya url="..." kullanın.
Blok biçimindeki satır içi HTML gömme kısa kodları işlenmez.
Web kullanıcı arayüzü kısa kodu görünür metinden çıkarır ve gömmeyi satır içinde işler.

Depolanan işleme biçimi

Normalleştirilmiş/depolanmış 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
  }
}

present_view tanınmaz; depolanan/işlenen zengin bloklar her zaman bu canvas biçimini kullanır.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Zengin çıktı protokolü

Medya ekleri

`[embed ...]`

Depolanan işleme biçimi

İlgili

​Medya ekleri

​[embed ...]

​Depolanan işleme biçimi

​İlgili

Medya ekleri

`[embed ...]`

Depolanan işleme biçimi

İlgili