助手输出支持一组投递/渲染指令,用于媒体附件、音频提示、回复元数据和富文本嵌入。
指令类型
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"
}
}