PeekabooV3 open claw的桌面自动化skill
Use Peekaboo for macOS desktop GUI automation, screen understanding, and MCP-backed local app control. Trigger when the user wants to inspect or control nati... Skill: PeekabooV3 open claw的桌面自动化skill Owner: zimuoo Summary: Use Peekaboo for macOS desktop GUI automation, screen understanding, and MCP-backed local app control. Trigger when the user wants to inspect or control nati... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-05-14T00:59:19.178Z | user Initial release of peekaboo-macos-automation. - Provides desktop GUI automation for macOS native apps using Peekaboo. -
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
1.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.0release · observed May 14, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17f3he19v8b83h56t09qrsw7n83kj3k:peekaboo-macos-automation- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-zimuoo-peekaboo-macos-automation/snapshot"
Documentation
CLAWHUB
9,309 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
--- name: peekaboo-macos-automation description: Use Peekaboo for macOS desktop GUI automation, screen understanding, and MCP-backed local app control. Trigger when the user wants to inspect or control native macOS apps, Finder, Notes, Xcode, Terminal, system dialogs, menu bar items, Dock, Spaces, or other non-browser UI; when they ask to click, type, scroll, drag, switch apps, handle popups, or automate a desktop workflow on Mac; or when they explicitly mention Peekaboo. If Peekaboo is missing, detect that first and proactively install it for the user, then continue. Prefer this over browser automation for native macOS interfaces. --- # Peekaboo macOS automation Use this skill to drive native macOS UI with Peekaboo. ## Core rules - Treat Peekaboo as an external local automation backend, not as a built-in tool. - Prefer `peekaboo` CLI via `exec`. - Detect installation before doing anything else. - If Peekaboo is not installed, proactively install it for the user, then verify installation before continuing. - Check permissions before first real automation step. - Prefer semantic actions over coordinate clicks whenever possible. - Use browser automation instead for web-page DOM tasks. ## Detection and installation Run these checks in order: ```bash command -v peekaboo peekaboo --version ``` If `peekaboo` is missing, install it proactively: ```bash brew install steipete/tap/peekaboo ``` After installation, verify again: ```bash command -v peekaboo && peekaboo --version ``` If Homebrew is missing, check for it first: ```bash command -v brew ``` If `brew` is also missing, ask one concise question before installing Homebrew or using another path. ## Permission check Before GUI actions, check permissions: ```bash peekaboo permissions status ``` If Screen Recording or Accessibility is missing, tell the user exactly what is missing and pause until granted. Do not pretend automation can succeed without them. For a quick readiness check, you can run: ```bash ~/.openclaw/skills/peekaboo-macos-automation/scripts/doctor.sh ``` ## Preferred workflow 1. Detect/install Peekaboo. 2. Check permissions. 3. If the task targets a specific native app window, bring that app to the foreground first. 4. Inspect the target UI. 5. Prefer semantic action APIs. 6. Fall back to synthetic input only when needed. 7. Re-inspect after state-changing actions when the next step depends on fresh UI state. Before `see`, `click`, `set-value`, or other window-level actions on a named app, do this first: ```bash peekaboo app switch --to "AppName" ``` If needed, unhide or launch it first: ```bash peekaboo app unhide --app "AppName" peekaboo app launch "AppName" ``` Do not assume a running app has a capturable front window. Bring it forward first, then inspect it. ## Inspection patterns Use structured inspection first. Start broad, then narrow: ```bash peekaboo list apps peekaboo app switch --to "Safari" peekaboo see --app "Safari" --json peekaboo image --mode
_meta.json
{
"ownerId": "kn76ps4ntx6kqdma4451pzs7g183krtg",
"slug": "peekaboo-macos-automation",
"version": "1.0.0",
"publishedAt": 1778720359178
}skill-card.md
## Description: Uses Peekaboo to inspect and automate native macOS desktop apps, including window focus, UI inspection, semantic actions, typing, clicking, and permission checks. This skill is ready for commercial/non-commercial use. ## Publisher: [zimuoo](https://clawhub.ai/user/zimuoo) ### License/Terms of Use: MIT-0 ## Use Case: Developers, operators, and macOS power users use this skill to let an agent inspect and control native macOS apps for desktop workflow automation when browser DOM tools are not applicable. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill can install a third-party desktop-control tool through Homebrew. Mitigation: Require explicit approval for the exact Homebrew install command before installing Peekaboo. Risk: Screen Recording and Accessibility permissions enable high-impact local app control. Mitigation: Grant permissions only for specific desktop tasks the user initiated, inspect the target UI first, and verify state-changing actions with command evidence. Risk: Native UI automation can affect user data or send content through local apps if the target is wrong. Mitigation: Ask before destructive, irreversible, bulk, message-sending, or credential-related actions, and prefer semantic actions over coordinate clicks. ## Reference(s): - [ClawHub skill release](https://clawhub.ai/zimuoo/skills/peekaboo-macos-automation) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with inline shell commands and occasional JSON command output] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires macOS, Homebrew for automatic install, Peekaboo, and Screen Recording and Accessibility permissions for GUI automation.] ## Skill Version(s): 1.0.0 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/zimuoo/skills/peekaboo-macos-automation",
"sourceUrl": "https://clawhub.ai/zimuoo/skills/peekaboo-macos-automation",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:52:42.460Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zimuoo-peekaboo-macos-automation/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zimuoo-peekaboo-macos-automation/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T16:52:42.460Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceUrl": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:52:42.460Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.0",
"href": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceUrl": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-14T00:59:19.178Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zimuoo-peekaboo-macos-automation/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zimuoo-peekaboo-macos-automation/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.0",
"description": "Initial release of peekaboo-macos-automation. - Provides desktop GUI automation for macOS native apps using Peekaboo. - Automatically detects and installs Peekaboo via Homebrew if missing. - Checks and prompts for required permissions (Screen Recording, Accessibility) before automation. - Follows a preferred sequence: detect/install, check permissions, focus app, inspect, act, and verify. - Includes clear troubleshooting steps and safety guidance for high-impact native UI actions.",
"href": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceUrl": "https://clawhub.ai/zimuoo/peekaboo-macos-automation",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-14T00:59:19.178Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
