Przejdź do głównej treści

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 może dołączać znormalizowane metadane MessagePresentation do wychodzących zdarzeń Matrix m.room.message w kluczu com.openclaw.presentation. Standardowe klienty Matrix nadal renderują zwykły tekst body. Klienty świadome OpenClaw mogą odczytywać ustrukturyzowane metadane i renderować natywny interfejs użytkownika, taki jak przyciski, listy wyboru, wiersze kontekstu i separatory.

​
Zawartość zdarzenia

Metadane są przechowywane w zawartości zdarzenia 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 to wersja schematu metadanych prezentacji Matrix. type to stabilny dyskryminator dla klientów świadomych OpenClaw. Klienty powinny ignorować nieznane wartości type, nieznane wersje, których nie mogą bezpiecznie zinterpretować, oraz nieznane typy bloków.

​
Zachowanie zastępcze

OpenClaw zawsze renderuje czytelny zastępczy zwykły tekst w body. Ustrukturyzowane metadane są dodatkiem i nie mogą być wymagane do podstawowej interoperacyjności Matrix. Nieobsługiwane klienty powinny nadal wyświetlać tekst zastępczy. Klienty świadome OpenClaw mogą preferować ustrukturyzowane metadane do wyświetlania, zachowując jednocześnie tekst zastępczy do kopiowania, wyszukiwania, powiadomień i dostępności.

​
Obsługiwane bloki

Adapter wychodzący Matrix deklaruje obsługę:
  • buttons
  • select
  • context
  • divider
Klienty powinny traktować te bloki jako wskazówki prezentacji typu best-effort. Nieznane pola i nieznane typy bloków powinny być ignorowane, zamiast powodować niepowodzenie renderowania całej wiadomości.

​
Interakcje

Te metadane nie dodają semantyki wywołań zwrotnych Matrix. Wartości przycisków i opcji wyboru są zastępczymi ładunkami interakcji, zwykle poleceniami ukośnikowymi lub poleceniami tekstowymi. Klient Matrix, który chce obsługiwać interakcję, może wysłać wybraną wartość z powrotem do pokoju jako normalną wiadomość. Na przykład przycisk o wartości /model deepseek/deepseek-chat można obsłużyć przez wysłanie tej wartości jako zaszyfrowanej wiadomości tekstowej Matrix w tym samym pokoju.

​
Relacja do metadanych zatwierdzania

com.openclaw.presentation służy do ogólnej prezentacji bogatych wiadomości. Monity zatwierdzania używają dedykowanych metadanych com.openclaw.approval, ponieważ zatwierdzenia zawierają stan wrażliwy z punktu widzenia bezpieczeństwa, decyzje oraz szczegóły exec/Plugin. Jeśli oba klucze metadanych są obecne w tym samym zdarzeniu, klienty powinny preferować dedykowany renderer zatwierdzania.

​
Wiadomości multimedialne

Gdy odpowiedź zawiera wiele adresów URL multimediów, OpenClaw wysyła jedno zdarzenie Matrix na każdy adres URL multimediów. Metadane prezentacji są dołączane tylko do pierwszego zdarzenia multimedialnego, aby klienty miały jeden stabilny ustrukturyzowany ładunek i aby uniknąć zduplikowanych rendererów. Metadane prezentacji powinny pozostać zwięzłe. Duży tekst widoczny dla użytkownika powinien pozostać w body i używać normalnej ścieżki dzielenia tekstu Matrix.