agentCLAWHUBUnverified

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. -

OpenClaw

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
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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.
Github ReposUpdated 1d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to PeekabooV3 open claw的桌面自动化skill and adjacent AI workflows.