windows-screenshot

name	windows-screenshot
description	Pure PowerShell GDI+ screenshot tool for Windows. No external dependencies, captures to PNG with automatic scaling.
homepage	https://github.com/vvxer/windows-screenshot
repository	https://github.com/vvxer/windows-screenshot
metadata	{"openclaw":{"emoji":"📸","requires":{"env":[]},"install":[]}}

Windows 屏幕截图

一个纯 PowerShell 的屏幕截图工具，使用 GDI+ 捕获 Windows 屏幕。

特性

• ✅ 纯 PowerShell - 无需外部依赖
• ✅ GDI+ 图像库 - 高效的系统级屏幕捕获
• ✅ 多屏支持 - 捕获主屏幕
• ✅ 自动缩放 - 根据屏幕 DPI 自适应分辨率
• ✅ PNG 输出 - 24-bit 彩色图像
• ✅ 开源 - GitHub 源码 MIT-0 许可证

源代码透明性

本技能的所有代码都完全开放在 GitHub 上，可供审查：

• 📝 screenshot.ps1 完整源码
• 📖 完整项目文档
• 📋 MIT-0 许可证

这不是"下载执行"的方式。脚本代码是自包含的，在技能包中可直接审查。

脚本文件说明

本技能包中包含 screenshot.txt（PowerShell 脚本内容）。使用时：

1. 将 screenshot.txt 复制或重命名为 screenshot.ps1
2. 在 PowerShell 中执行：powershell -File screenshot.ps1

或者直接使用 GitHub 仓库中的脚本。

环境变量

脚本会自动检查以下环境变量（可选）：

• OPENCLAW_MEDIA_DIR - 自定义输出目录
  • 若未设置，默认使用 $USERPROFILE\.openclaw\media
  • 脚本会自动创建此目录

设置环境变量示例

PowerShell:

$env:OPENCLAW_MEDIA_DIR = "C:\MyScreenshots"
powershell -File screenshot.ps1

Command Prompt:

set OPENCLAW_MEDIA_DIR=C:\MyScreenshots
PowerShell -File screenshot.ps1

使用方法

方法 1：直接执行

powershell -File screenshot.ps1

输出：

MEDIA:C:\Users\YourUsername\.openclaw\media\screenshot_YYYYMMDD_HHMMSS.png

方法 2：通过 OpenClaw

openclaw exec powershell -File screenshot.ps1

方法 3：发送到 Telegram（需要配置环境变量）

# 步骤 1：捕获截图
openclaw exec powershell -File screenshot.ps1

# 步骤 2：发送（需要 TELEGRAM_BOT_TOKEN 和用户 ID）
openclaw message send --channel telegram --target YOUR_USER_ID --media /path/to/screenshot.png

输出

脚本将截图保存为 PNG：

.openclaw/media/screenshot_YYYYMMDD_HHMMSS.png

并输出 MEDIA: 前缀路径用于后续处理。

技术细节

属性	值
图像库	System.Drawing (GDI+)
格式	PNG 24-bit
分辨率	自适应（根据屏幕缩放）
文件大小	通常 50-200 KB
依赖	.NET Framework 4.x+（Windows 内置）

故障排查

问题	解决方案
"找不到类型 System.Drawing"	在 .NET Framework 4.x+ 上运行（Windows 默认）
图像全黑	检查屏幕/GPU 状态；确保不在锁屏
文件名冲突	脚本使用时间戳自动避免重复

许可

MIT-0 - 无署名、无限制使用、修改和分发。

---

安全声明

✅ 所有代码都是开源的且经过审查

• 脚本功能：捕获屏幕内容到 PNG 文件
• 数据处理：仅保存到本地 .openclaw/media 目录
• 网络请求：无（除非显式使用 Telegram 集成）
• 隐私：仅在用户明确调用时执行

源码：https://github.com/vvxer/windows-screenshot