跳转到内容

消息类型

微信消息你获得的内容在 OpenClaw 中
文本body消息文本
图片可下载的图片,取可用的最高画质展示给模型
文件(PDF 等)可下载的文件作为附件的文件
视频可下载的 MP4作为附件的视频
语音自动缓存的音频若已配置则为转录文本;否则为附件音频
动态表情表情的原始字节图片
引用回复body 中为评论,并附带回复中内嵌的被引用内容评论和带标签的引用内容
合并转发聊天记录可读的发言人与内容列表同样的文本
链接卡片(文章、音乐、视频)标题、描述、URL、来源、可选缩略图卡片文字和缩略图
静态位置location 坐标、附带的地名/地址,以及可读的 body位置文本
位置共享通知(49/17)附带的标题文字被动通知;不会加入共享
普通系统通知附带的文字,无消息作者不会开启新的智能体轮次
已撤回的消息[Message recalled]从待处理工作中移除
其他标记为不支持不发送给智能体

文本表情

桌面端和 Web 端应用会把识别到的微信表情代号(例如 [微笑] 和 [Lol])显示为 Unicode 表情。部分表情使用近似的替代图案,具体外观取决于你的设备。桌面系统通知使用同样的映射规则。无法识别的代号和已有的 Unicode 表情保持不变,URL 的拼写也保持原样。发送、复制、搜索以及 API 响应仍保留原始消息文本。

位置信息

静态位置消息提供 location.latitude、longitude,以及可选的 name、address、scale、mapType 和 poiId,并附带可读的 body。坐标系统报告为 unknown;坐标不会被转换,也不会自动请求任何地图服务。桌面应用会显示一张位置卡片,提供两个 Google 地图操作:搜索地点(Search place) 会把地名/地址和分享的坐标作为搜索上下文,查看标注(View pin) 则直接打开分享的坐标。搜索结果不受严格的范围限制。你也可以复制坐标;不会进行任何坐标转换。OpenClaw 应用常规的发送者规则和群聊 @ 提醒规则。

位置共享通知只显示发送者提供的标题,不会开始或加入实时位置共享,也不会下载地图缩略图。

语音留言

wx 守护进程会自动下载新收到的语音留言,并准备好可播放的音频。这一过程不需要打开浏览器或 OpenClaw 会话。下载使用常规的媒体任务,守护进程重启后可以继续,账号断开连接时会暂停。已取消或失败的任务可以通过媒体 API 查看;系统不会悄悄重新提交。本地修复不会下载新的媒体。

引用

收到的引用只使用微信服务器协议随回复一起送达的内容。通过 GET /messages/{id} 或常规的消息列表接口读取回复:其 body 为当前的评论,quote 包含被引用消息的服务端 ID、发送者、类型、解析后的文本以及媒体可用性。被引用的文章、音乐和视频卡片还会在 quote.embeddedLink 中提供与普通链接相同的标题、描述、URL 和来源字段。OpenClaw 直接从这些字段渲染文字和链接卡片的详情。本地保存的原始消息绝不会替换引用中的摘要。本地撤回检查仍会屏蔽已撤回的内容。

提供 quote.senderName 时,它是回复中携带的作者显示名称。

图片、受支持的表情和链接缩略图可以使用引用中内嵌的元数据下载。桌面端和 Web 端以紧凑的卡片或小图预览的形式显示引用;点击引用可跳转到对应消息。缺失或过期的媒体会在评论旁以状态形式保留。被引用的语音、视频和文件会保留评论和受支持的摘要,附件显示为不可用;其实际附件不会从本地保存的原始消息中获取。

即使被引用的原始消息没有保存在本地,嵌入的引用也能显示。媒体获取使用父级回复的 ID。要发送你自己的引用回复,请使用普通的发送接口,并填入已保存目标消息的消息 ID 和服务端 ID。参见发送引用回复。

分享的表情

普通表情(类型 47)和受支持的分享表情(应用子类型 8)使用相同的下载和图片校验流程。动态原图会保留动画效果。原图下载期间可以先显示缩略图;原图遵循账号的自动下载限制。来源或加密方式不受支持的表情仍不可用。

合并转发的聊天记录

合并转发的聊天记录会转换为纯文本:每位发言人和每条消息各占一行,嵌套的记录会缩进显示。记录中的图片和文件只显示为占位文字,不会被下载。

收到的类型显示方式和限制
分享的文本(子类型 1)纯文本;完整的 HTTP(S) URL 可点击。
微信视频号(51)封面、描述、发布者和时长。只有在你打开或请求时才会下载视频,之后可像收到的视频一样播放和保存。
文件上传通知(74)文件名提示;不说明当前进度或最终是否可用。不会触发 OpenClaw 模型处理。
群公告(87)纯文本形式的公告内容。

分享的文本、视频号卡片和群公告都可以被引用和撤回。收到的文件上传通知的引用可以显示,但上传通知本身不能被选作回复的目标。引用预览使用回复中携带的文字。

你可以使用 wx messages send --share URL --title ... 或 wechat_send_share 工具发送分享卡片。你需要提供标题、描述和缩略图 URL;系统不会从页面抓取任何内容。

撤回

有人撤回消息时,守护进程会把该消息保存的正文替换为撤回通知,同时保留消息 ID 和在时间线中的位置。即使本地已有缓存,其媒体也无法再获取(HTTP 410)。你可以使用 wx messages recall 或 wechat_recall 工具撤回自己发出的消息;是否仍可撤回由微信服务器决定。

API 会将 body 保持为 [Message recalled],并在保存的通知中有 recall.replacementText 时读取它。原消息的 senderId 和 direction 来自原始记录,或已有的同步和发送成功回执,系统不会额外保存第二份作者信息。证据缺失或互相冲突时,这些字段为 null。撤回事件会指明受影响的消息;如需最新详情,请重新获取该消息。

对于支持的官方全文搜索索引,撤回还会删除原消息的条目及其搜索词。其他条目保持不变。遇到不认识的索引结构时,本地清理会保持待处理状态,等待检查。