openclaw ai支持四类视频输出通道:一、本地文件系统(mp4/webm);二、websocket流式h.264帧推送;三、ffmpeg rtmp推流;四、嵌入式chromium png序列帧。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望 OpenClaw AI 在执行任务过程中输出视频内容(例如屏幕录制、GUI 自动化操作回放、浏览器操作可视化反馈等),则需了解其支持的视频输出通道类型。OpenClaw 并不直接渲染视频帧,而是通过标准化接口将视频流或视频文件交付至外部显示/存储系统。以下是支持的视频输出接口类型:
一、本地文件系统输出(MP4/WebM 格式)
OpenClaw 的 Screen Capture 与 Browser Automation 插件默认将录制结果保存为本地视频文件,采用 FFmpeg 后端编码,支持 H.264/AAC(MP4)与 VP9/Opus(WebM)双格式输出,适用于离线回溯与归档。
1、在指令中显式指定录制需求,例如:“请录制接下来30秒的桌面操作并保存为视频”。
2、执行完成后,OpenClaw 自动在 workspace/output/video/ 目录下生成带时间戳的 .mp4 文件,如 video_20260406_134522.mp4。
3、可通过 openclaw-cli list output --type video 命令查看最近生成的全部视频文件路径。
4、若需自定义编码参数,可编辑 ~/.openclaw/config.yaml 中的 video_output 配置段,设置 preset、crf、fps 等字段。
二、WebSocket 流式视频帧推送(H.264 Annex B over Binary)
当启用 WebSocket 网关模式时,OpenClaw 支持以二进制消息形式向已连接客户端持续推送原始 H.264 编码帧(Annex B 格式),由前端使用 MediaSource Extensions(MSE)进行实时解码与播放,适用于远程监控、低延迟操作反馈等场景。
1、确保网关已启动且 WebSocket 功能启用:openclaw gateway --port 18789 --ws-enable。
2、客户端建立 WebSocket 连接至 ws://127.0.0.1:18789/ws/video?session_id=abc123。
3、发送 JSON 控制指令:{"action":"start_screen_capture","region":[0,0,1920,1080],"fps":15}。
4、服务端随后连续发送 Binary Type 消息,每条含一个完整 NALU 单元,首帧必须为 SPS+PPS+NALU_IDR,客户端须据此初始化 MSE SourceBuffer。
三、FFmpeg RTMP 推流输出(推送到自建流媒体服务器)
OpenClaw 可调用本地 FFmpeg 进程,将屏幕捕获或浏览器视图实时编码并推流至支持 RTMP 协议的服务器(如 Nginx-RTMP、SRS、OBS-Studio 接收端),实现多终端同步观看与直播分发。
1、确认系统已安装 FFmpeg 6.0+,且可通过命令行执行 ffmpeg -version。
2、在 workspace/config/video_stream.yaml 中配置目标地址:rtmp://192.168.1.100/live/openclaw_stream。
3、执行指令:“开始向 RTMP 服务器推送当前桌面画面”,OpenClaw 将自动启动后台 ffmpeg 子进程。
4、推流期间,日志中将持续输出 ffmpeg 的 encoder stats 行,包含 bitrate、frame drop count 等关键指标。
四、嵌入式 Chromium 截图序列(PNG 序列帧)
针对无法支持视频硬编码的轻量环境(如 ARM64 Windows on Snapdragon 或低配虚拟机),OpenClaw 提供“截图序列”替代方案:以固定间隔截取浏览器或应用窗口 PNG 图像,并打包为 ZIP 或生成 HTML 动画页面,便于人工快速浏览操作轨迹。
1、触发方式为自然语言指令中包含“逐帧截图”“生成操作快照”等关键词。
2、系统自动创建 workspace/output/screenshots/YYYYMMDD_HHMMSS/ 目录,内含按毫秒命名的 PNG 文件(如 000000.png、000500.png)。
3、同步生成 index.html 文件,使用 CSS animation + base64 img src 实现免依赖播放,双击即可在默认浏览器中循环播放。
4、可通过 openclaw script run --file screenshot_to_gif.py 将该序列转为 GIF(需 Python 插件已启用)。










