浏览器截图发送

技能标识：browser-screenshot-send

Automatically send browser screenshots to users via message tool. Solves the common issue where browser screenshots are generated but not delivered to the conversation channel. Essential for web automation workflows requiring visual feedback.

作者：admin | 来源记录：ClawHub

浏览器截图发送

通过消息渠道自动向用户发送浏览器截图。该技能弥合了浏览器自动化与用户通信之间的差距。

解决的问题

使用 browser action=screenshot 时，截图会保存到磁盘，但不会自动发送给用户。许多代理错误地使用 read 来显示截图，但这种方式无法可靠地通过聊天渠道传输图像。

本技能确保截图真正送达用户手中。

使用场景

- 任何需要用户查看结果的 browser screenshot 操作之后
网页抓取结果可视化
UI自动化进度报告
页面验证与调试
可视化测试工作流

快速开始

1. 截图

browser action=screenshot targetId=

返回：MEDIA:/root/.openclaw/media/browser/.png

2. 发送给用户

message action=send media=/root/.openclaw/media/browser/.png

为什么不用 read？

❌ 不要使用：read file_path=/path/to/screenshot.png

- 仅在代理上下文中显示
不会传输到聊天渠道
用户看不到任何内容

✅ 应该使用：message action=send media=/path/to/screenshot.png

- 主动推送到对话中
适用于所有渠道（Slack、Discord、Telegram等）
用户能收到图片

处理长截图

对于可能过长的整页截图：

方案一：直接发送并附带提示

message action=send media=
注意：这是整页截图，可能较长。

方案二：分段发送
当用户要求分段发送时，使用 canvas 工具裁剪不同部分。

方案三：部分截图

browser action=screenshot fullPage=false

滚动并重复对不同区域截图

文件管理

截图自动保存至：

- 源文件：/root/.openclaw/media/browser/.png
建议：复制到工作区以持久保存：

cp <源文件> /workspace/media/screenshots/<描述性名称>.png

工作流示例

导航并截图

browser action=navigate targetUrl=https://example.com browser action=screenshot fullPage=true

在 MEDIA: 行返回路径

MEDIA:/root/.openclaw/media/browser/abc123.png

发送给用户

message action=send media=/root/.openclaw/media/browser/abc123.png

最佳实践

1. 始终使用 message 工具 - 切勿依赖 read 向用户展示图片
复制到工作区 - 浏览器媒体文件是临时的，重要截图请保存
使用描述性命名 - 复制时使用有意义的文件名
长截图需提示 - 整页截图可能非常高

系统要求

- 已启用 browser 和 message 工具的 OpenClaw
兼容所有 OpenClaw 支持的渠道

浏览器截图发送