助手输出支持一组投递/渲染指令,用于媒体附件、音频提示、回复元数据和富文本嵌入。

指令类型

MEDIA: — 媒体附件投递

  • 远程附件:必须是公开 https: URL(http:、本地回环、私有地址均被忽略)
  • 本地附件:支持绝对路径、工作区相对路径、~/ 路径
  • 同一轮次重复出现时只投递一次

audio_as_voice — 音频呈现提示

标记音频附件以语音消息形式投递。

reply_to_current / reply_to:<id> — 回复元数据

指定回复目标消息。

[embed ...] — Control UI 富文本渲染

仅用于 Control UI 的富文本渲染,其他指令不可替代:

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

规则:

  • 只有 URL 支持的 embed 才会渲染(使用 ref="..." 或 url="...")
  • Web UI 从可见文本中剥离 shortcode 并内联渲染
  • [view ...] 已废弃,不再有效

存储格式

富文本块以 canvas 结构存储:

{
  "type": "canvas",
  "preview": {
    "kind": "canvas",
    "surface": "assistant_message",
    "render": "url",
    "viewId": "cv_123",
    "url": "/__openclaw__/canvas/documents/cv_123/index.html",
    "title": "Status"
  }
}

相关页面