Skills desktop-operator

Operate Electron desktop applications on macOS via Puppeteer CDP. Open an app, find a UI element by text, click it, and take a screenshot.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bondli/desktop-operator" ~/.claude/skills/openclaw-skills-desktop-operator && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bondli/desktop-operator" ~/.openclaw/skills/openclaw-skills-desktop-operator && rm -rf "$T"
manifest: skills/bondli/desktop-operator/SKILL.md
source content

desktop-operator

通过 Puppeteer CDP 连接 Electron 桌面应用,自动完成打开应用、点击指定文本元素、截图的操作。

适用场景

用于自动化本地 Electron 应用(如各类管理后台、工具软件)。

示例触发语:

  • 打开 DaveBella 应用,点击订单中心,然后截图
  • 打开 xx 应用,点击顶部的订单中心
  • 打开 xx 应用,进入数据分析页面截图

Parameters

参数说明
--app
应用名称,即
/Applications/
.app
文件名(不含 .app)
--target
要点击的元素文本内容

Execution

node dist/index.js --app "{appName}" --target "{targetText}"

示例:

node dist/index.js --app "DaveBella" --target "订单中心"

Output

成功后输出 JSON:

{ "screenshot": "/tmp/desktop_operator_skill_xxxxxxxxx.png" }

截图路径即为操作完成后的页面截图,可直接展示给用户。


注意事项

  • 仅适用于 Electron 应用
  • 应用需安装在
    /Applications/
    目录下
  • 首次使用需在「系统设置 → 隐私与安全性 → 辅助功能」中授权 Terminal