Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw може додавати нормалізовані метадані MessagePresentation до вихідних подій Matrix m.room.message у com.openclaw.presentation. Стандартні клієнти Matrix і далі відображають звичайний текст body. Клієнти з підтримкою OpenClaw можуть читати структуровані метадані й відображати нативний UI, як-от кнопки, списки вибору, контекстні рядки та розділювачі.

​
Вміст події

Метадані зберігаються у вмісті події Matrix: 
{
  "msgtype": "m.text",
  "body": "Select model\n\n- DeepSeek: /model deepseek/deepseek-chat",
  "com.openclaw.presentation": {
    "version": 1,
    "type": "message.presentation",
    "title": "Select model",
    "tone": "info",
    "blocks": [
      {
        "type": "select",
        "placeholder": "Choose model",
        "options": [
          {
            "label": "DeepSeek",
            "value": "/model deepseek/deepseek-chat"
          }
        ]
      }
    ]
  }
}
version — це версія схеми метаданих презентації Matrix. type — стабільний дискримінатор для клієнтів із підтримкою OpenClaw. Клієнти мають ігнорувати невідомі значення type, невідомі версії, які вони не можуть безпечно інтерпретувати, і невідомі типи блоків.

​
Поведінка резервного відображення

OpenClaw завжди відтворює читабельний резервний звичайний текст у body. Структуровані метадані є додатковими й не повинні бути обов’язковими для базової сумісності з Matrix. Непідтримувані клієнти мають і далі показувати резервний текст. Клієнти з підтримкою OpenClaw можуть віддавати перевагу структурованим метаданим для відображення, зберігаючи резервний текст для копіювання, пошуку, сповіщень і доступності.

​
Підтримувані блоки

Вихідний адаптер Matrix оголошує підтримку для:
  • buttons
  • select
  • context
  • divider
Клієнти мають розглядати ці блоки як презентаційні підказки за принципом найкращого зусилля. Невідомі поля й невідомі типи блоків слід ігнорувати, а не спричиняти збій відображення всього повідомлення.

​
Взаємодії

Ці метадані не додають семантики зворотних викликів Matrix. Значення кнопок і варіантів вибору є резервними корисними навантаженнями взаємодії, зазвичай slash-командами або текстовими командами. Клієнт Matrix, який хоче підтримувати взаємодію, може надіслати вибране значення назад у кімнату як звичайне повідомлення. Наприклад, кнопку зі значенням /model deepseek/deepseek-chat можна обробити, надіславши це значення як зашифроване текстове повідомлення Matrix у тій самій кімнаті.

​
Зв’язок із метаданими схвалення

com.openclaw.presentation призначено для загального розширеного представлення повідомлень. Запити на схвалення використовують спеціальні метадані com.openclaw.approval, оскільки схвалення містять чутливий до безпеки стан, рішення та відомості про exec/plugin. Якщо обидва ключі метаданих присутні в одній події, клієнтам слід віддавати перевагу спеціалізованому рендереру схвалень.

​
Медіаповідомлення

Коли відповідь містить кілька медіа-URL, OpenClaw надсилає одну подію Matrix для кожного медіа-URL. Метадані презентації додаються лише до першої медіаподії, щоб клієнти мали одне стабільне структуроване корисне навантаження й уникали дублювання рендерерів. Тримайте метадані презентації компактними. Великий видимий для користувача текст має залишатися в body і використовувати звичайний шлях поділу тексту Matrix на фрагменти.