Image and Media Support

这个“魔法小助手”是通过一个叫 WhatsApp 的聊天软件来工作的。它很聪明，能帮你发送和接收各种好玩的文件，比如照片、声音、视频，还有普通的文件。

怎么让小助手帮你发送媒体文件呢？ 你可以用一条“魔法咒语”来告诉它。这条咒语是：openclaw message send --media <文件路径或网址>。你只需要把你想发送的文件放在电脑上的位置告诉它，或者直接给它一个网上的链接就行啦。你还可以用 --message 在后面加上你想说的话。如果你想先看看小助手准备做什么，可以用 --dry-run 命令让它先“排练”一下。

小助手是怎么处理这些文件的呢？ 它会先看看你给的是什么文件。

1. 如果是图片，小助手会帮它“减肥”，让它变得小一点（最长的一边不会超过 2048 个像素点），这样发送起来更快。但“减肥”后最大不能超过 6MB。
2. 如果是声音或者视频，小助手会直接发送，只要它们不超过 16MB 就行。如果是声音，小助手会把它变成“语音消息”的格式发出去。
3. 如果是其他文件（比如一个文档），只要不超过 100MB，小助手也能发，并且会尽量保留原来的文件名。
4. 如果你想发一个会动的图片（GIF），你需要告诉小助手这是一个 GIF，用 --gif-playback 这个选项，这样它就会用一种特殊的方式发送，让你的朋友在手机上看到它会自动循环播放。

如果朋友发来带媒体文件的消息，小助手怎么处理？ 当朋友发来照片或语音时，小助手会先把它们下载到电脑上一个临时的位置。

1. 然后，小助手可以用这些文件来做一些事情。比如，它会用一些“魔法词语”来代表这些文件：{{MediaUrl}} 代表文件的网上地址，{{MediaPath}} 代表文件在电脑上的位置。
2. 如果小助手开启了“安全沙箱”模式（就像一个独立的游戏室），它会把朋友发来的文件先复制到“游戏室”里，再用新的位置来工作。
3. 小助手还能“看懂”或“听懂”这些文件！如果它配置了“媒体理解”功能，它会先看看图片里有什么、听听语音里说了什么，然后把理解到的内容加到消息里。这样，即使朋友只发了一张图，小助手也能明白他的意思并做出回应。语音会被转成文字，方便小助手理解。

这里有一些重要的规矩和提醒：

• 发送大小限制：图片不能超过约 6MB，声音和视频不能超过 16MB，其他文件不能超过 100MB。如果文件太大或者打不开，小助手会告诉你错误，并且不会发送回复。
• 理解大小限制：为了让小助手“看懂”或“听懂”，文件也不能太大。图片默认要小于 10MB，声音小于 20MB，视频小于 50MB。如果太大，小助手就跳过理解这一步，但正常的回复还是会发送的。
• 一次处理一个：默认情况下，如果朋友一次发来很多图片或语音，小助手只处理第一个。如果你想让它处理更多，需要特别告诉它。