- name
- wallpaper-auto-switch-pro-executable
- description
- 在 macOS 本机从本地壁纸文件夹中立即换壁纸，或安装 launchd 定时轮换任务的可执行技能。
- metadata
- {"openclaw":{"emoji":"🖼️","requires":{"bins":["bash","osascript","find","gshuf"]}},"tags":["wallpaper","desktop","macos","automation","launchd"],"category":"desktop-automation"}
Wallpaper Auto Switch Pro Executable
这是一个 可执行版 的 macOS 壁纸轮换技能。
它与“说明型 skill”不同：
- 自带本地脚本
- 能立即切换壁纸
- 能安装 launchd 定时任务
- 能卸载定时任务
- 不假装联网搜索或自动下载图片
适用范围
仅适用于 macOS，并且要求用户已经准备好了一个本地壁纸文件夹。
支持这些任务：
- 立刻从某个文件夹随机换一张壁纸
- 检查某个文件夹里有多少可用图片
- 安装每 N 分钟自动轮换一次的 launchd 任务
- 卸载已经安装的自动轮换任务
- 查看当前 launchd 任务配置路径
不做的事情
- 不自动联网下载壁纸
- 不伪造“已换成功”
- 不支持 Windows 或 Linux
- 不支持 WeChat / QQ / 手机壁纸
- 不依赖虚构的 OpenClaw 壁纸 UI 页面
依赖
本 skill 依赖以下 macOS 本机能力：
bashosascriptfindshuf
默认图片后缀
会识别以下图片格式：
- jpg
- jpeg
- png
- heic
- webp
使用方式
1. 立即随机换壁纸
当用户说：
- 立刻从某个文件夹换一张壁纸
- 帮我随机切换桌面背景
- 用本地壁纸目录马上换一张
你应运行：
bash {baseDir}/scripts/rotate_once.sh "/Users/用户名/Pictures/WallpaperAuto"如果用户没有给目录，优先建议这些常用目录：
~/Pictures/WallpaperAuto~/Pictures/Wallpapers~/Desktop/wallpapers
2. 检查文件夹中可用壁纸数量
当用户说：
- 检查这个文件夹能不能用
- 看看这个目录里有多少张壁纸
- 帮我列出可用图片
你应运行：
bash {baseDir}/scripts/list_images.sh "/Users/用户名/Pictures/WallpaperAuto"3. 安装自动轮换任务
当用户说：
- 帮我安装自动换壁纸
- 每 60 分钟自动切换一次
- 用 launchd 定时轮换壁纸
你应运行：
bash {baseDir}/scripts/install_launchagent.sh "/Users/用户名/Pictures/WallpaperAuto" 60第二个参数是分钟数。
4. 卸载自动轮换任务
当用户说：
- 关闭自动换壁纸
- 卸载壁纸轮换任务
- 停止定时换壁纸
你应运行：
bash {baseDir}/scripts/uninstall_launchagent.sh输出要求
如果是“立即换壁纸”
输出：
- 使用的文件夹
- 是否成功
- 实际设置的文件路径
- 如果失败，明确失败原因
如果是“安装自动轮换”
输出：
- 壁纸目录
- 轮换间隔（分钟）
- launchd plist 路径
- 是否安装成功
- 如何卸载
如果是“检查文件夹”
输出：
- 目录是否存在
- 可识别图片数量
- 前几个文件名示例
- 是否建议继续安装自动轮换
真实性要求
- 只有脚本命令真实成功后，才能说“已安装”或“已切换”
- 如果目录不存在、图片数量为 0、launchd 加载失败、osascript 执行失败，必须明确报错
- 不要假装已创建 schedule
- 不要假装已成功切换桌面
安全与兼容性要求
- 只操作用户明确提供的目录
- 不删除用户图片
- 不移动用户文件
- launchd 仅写入当前用户的
~/Library/LaunchAgents - 默认 label：
com.openclaw.wallpaperrotator
推荐回答策略
A. 用户只说“帮我自动换壁纸”
先问或建议：
- 你的壁纸文件夹在哪里？
- 如果没有，建议使用
~/Pictures/WallpaperAuto - 你想每隔多少分钟/小时切换？
B. 用户已经有目录
优先先检查目录：
bash {baseDir}/scripts/list_images.sh "目录"如果目录可用，再继续：
- 立刻切换一次
- 或安装定时任务
C. 用户要求“马上执行”
优先执行 rotate_once.sh。
常用目录建议
~/Pictures/WallpaperAuto~/Pictures/Wallpapers
示例
用户：帮我把 ~/Pictures/WallpaperAuto 设成随机壁纸并马上切换。 你应运行：
bash {baseDir}/scripts/rotate_once.sh "$HOME/Pictures/WallpaperAuto"用户：帮我每 120 分钟自动换一次壁纸，目录是 ~/Pictures/WallpaperAuto。 你应运行：
bash {baseDir}/scripts/install_launchagent.sh "$HOME/Pictures/WallpaperAuto" 120