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

# Giao thức đầu ra phong phú

Đầu ra của trợ lý có thể mang một nhóm nhỏ các chỉ thị phân phối/kết xuất:

* các trường `mediaUrl` / `mediaUrls` có cấu trúc để phân phối tệp đính kèm
* `[[audio_as_voice]]` cho gợi ý trình bày âm thanh
* `[[reply_to_current]]` / `[[reply_to:<id>]]` cho siêu dữ liệu trả lời
* `[embed ...]` cho kết xuất phong phú trong Control UI

Tệp đính kèm phương tiện từ xa phải là URL `https:` công khai. `http:` thuần,
loopback, link-local, riêng tư và tên máy chủ nội bộ sẽ bị bỏ qua dưới dạng chỉ thị
tệp đính kèm; các bộ tải phương tiện phía máy chủ vẫn thực thi các rào chắn mạng
riêng của chúng.

Tệp đính kèm phương tiện cục bộ có thể dùng đường dẫn tuyệt đối, đường dẫn tương đối
với workspace, hoặc đường dẫn tương đối với thư mục home `~/`. Chúng vẫn đi qua
chính sách đọc tệp của tác nhân và kiểm tra loại phương tiện trước khi phân phối.

<Warning>
  Không phát ra lệnh văn bản cho tệp đính kèm từ công cụ, Plugin, khối streaming,
  đầu ra trình duyệt hoặc hành động tin nhắn. Hãy dùng các trường phương tiện có cấu trúc thay thế.

  Payload công cụ tin nhắn hợp lệ:

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  { "message": "Here is your image.", "mediaUrl": "/workspace/image.png" }
  ```

  Văn bản trả lời cuối kiểu cũ của trợ lý vẫn có thể được chuẩn hóa để tương thích, nhưng
  đó không phải là giao thức Plugin/công cụ tổng quát.
</Warning>

Cú pháp ảnh Markdown thuần vẫn là văn bản theo mặc định. Các kênh chủ động
ánh xạ trả lời ảnh Markdown sang tệp đính kèm phương tiện sẽ opt in tại
adapter gửi đi của chúng; Telegram làm điều này để `![alt](url)` vẫn có thể trở thành trả lời phương tiện.

Các chỉ thị này tách biệt với nhau. Trường phương tiện có cấu trúc và thẻ trả lời/giọng nói là
siêu dữ liệu phân phối; `[embed ...]` là đường dẫn kết xuất phong phú chỉ dành cho web.

Khi bật streaming theo khối, phương tiện phải được mang trên các trường payload
có cấu trúc. Nếu cùng một URL phương tiện được gửi trong một khối streamed và lặp lại trong
payload cuối của trợ lý, OpenClaw phân phối tệp đính kèm một lần và loại bỏ bản
trùng lặp khỏi payload cuối.

## `[embed ...]`

`[embed ...]` là cú pháp kết xuất phong phú duy nhất dành cho tác nhân trong Control UI.

Ví dụ tự đóng:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
[embed ref="cv_123" title="Status" /]
```

Quy tắc:

* `[view ...]` không còn hợp lệ cho đầu ra mới.
* Shortcode embed chỉ kết xuất trong bề mặt tin nhắn của trợ lý.
* Chỉ các embed dựa trên URL mới được kết xuất. Dùng `ref="..."` hoặc `url="..."`.
* Shortcode embed HTML nội tuyến dạng khối không được kết xuất.
* Giao diện web loại bỏ shortcode khỏi văn bản hiển thị và kết xuất embed nội tuyến.
* Phương tiện có cấu trúc không phải là bí danh embed và không nên dùng để kết xuất embed phong phú.

## Hình dạng kết xuất được lưu trữ

Khối nội dung trợ lý đã chuẩn hóa/được lưu trữ là một mục `canvas` có cấu trúc:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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
  }
}
```

Các khối phong phú được lưu trữ/kết xuất dùng trực tiếp hình dạng `canvas` này. `present_view` không được nhận diện.

## Liên quan

* [RPC adapters](/vi/reference/rpc)
* [Typebox](/vi/concepts/typebox)