openclaw提供四种纯净截图方案：一、无gui托管浏览器隔离；二、窗口级捕获api屏蔽非目标区域；三、配置openclaw.json启用全局净化策略；四、nanobot插件语义级过滤。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用OpenClaw进行游戏界面截图时发现画面中包含任务栏、通知弹窗、悬浮窗口等干扰元素，导致截图不纯净，则可能是由于系统级UI层未被有效隔离。以下是实现OpenClaw隐藏游戏界面并启用纯净截图模式的具体方法：
一、启用无GUI托管浏览器隔离模式
该方法通过启动一个完全独立的、无系统UI叠加的Chromium实例来运行游戏网页，从根本上避免桌面元素混入截图。此模式适用于WebGL类网页游戏或基于Electron封装的游戏前端。
1、关闭所有已打开的浏览器进程，确保无Chrome/Edge残留进程占用端口。
2、执行命令启动无头托管浏览器并加载游戏地址：
openclaw browser start --headless --no-sandbox --disable-gpu --window-size=1920,1080 --url=https://game.example.com
3、待页面加载完成后，执行纯净截图命令：
openclaw browser snapshot active --format=png --quality=100 --output=/path/to/clean-screenshot.png
4、验证截图结果：输出图像应仅含游戏渲染内容，无任何操作系统状态栏、窗口边框或系统通知图标。
二、调用OpenClaw窗口级捕获API屏蔽非目标区域
该方法利用OpenClaw底层的窗口枚举与区域锁定能力，强制限定截图范围为游戏主窗口客户区，同时动态隐藏其父容器及重叠子窗口，适用于本地客户端游戏（如Unity、Unreal引擎打包的.exe程序）。
1、确认游戏进程名称，例如“StardewValley.exe”或“Cyberpunk2077.exe”，可通过任务管理器查看。
2、执行窗口定位与纯净捕获命令：
openclaw capture window --process-name="StardewValley.exe" --region=client --hide-overlays=true --output=/screenshot/clean.png
3、若游戏使用全屏独占模式，需额外添加参数强制兼容：
--force-exclusive-mode=false
4、执行后系统将自动最小化任务栏、禁用DWM合成效果，并临时冻结所有非游戏相关窗口的Z-order层级，确保截图区域绝对干净。
三、配置openclaw.json启用全局纯净快照策略
该方法通过修改OpenClaw核心配置，使所有后续截图命令默认启用UI净化逻辑，包括自动隐藏托盘图标、禁用屏幕录制水印、屏蔽输入法候选框等隐蔽干扰源。
1、打开配置文件路径：
~/.openclaw/openclaw.json（macOS/Linux）或 %APPDATA%\OpenClaw\openclaw.json（Windows）
2、在“capture”节点下新增以下键值：
"clean_mode": true,
"hide_taskbar": true,
"suppress_ime": true,
"remove_watermark": true
3、保存文件后重启OpenClaw网关服务：
openclaw gateway restart
4、此后所有调用openclaw capture或openclaw browser snapshot的命令，都将自动应用上述净化规则，无需每次手动指定参数，且对DirectX/OpenGL/Vulkan渲染的游戏画面同样生效。
四、使用nanobot插件实现游戏UI语义级过滤
该方法结合nanobot内置的Qwen3-4B-Instruct-2507多模态模型，在截图生成后实时识别并擦除非游戏核心UI元素（如广告横幅、社交插件按钮、直播打赏浮层），保留原始游戏画布结构，属于后处理增强型纯净模式。
1、确保已安装nanobot-openclaw插件：
pip install nanobot-openclaw
2、运行语义净化命令，指定游戏类型标签提升识别精度：
nanobot clean-screenshot --input=/screenshot/raw.png --game-type="mmorpg" --output=/screenshot/pure.png
3、nanobot将自动标注并移除如下元素：
• 第三方SDK植入的悬浮按钮
• 实时语音通话状态徽章
• 游戏平台Overlay（如Steam、Epic小图标）
• 动态活动倒计时横幅
4、最终输出图像保留100%原始游戏渲染像素，仅删除被模型判定为“非游戏功能必需”的覆盖层元素，不改变画面比例或引入插值失真。
