Peekaboo

• steipete/Peekaboo
  • macOS CLI, MCP
  • author of openclaw
  • 核心功能：
    • 截屏
    • GUI 自动化
    • 结构化菜单发现
    • 多模型供应商集成
    • MCP 服务 (Tools 与 CLI 保持一致)：
      • 视觉感知: see, image, list
      • 键鼠交互: click, press, type, hotkey, scroll, swipe, drag, move
      • 系统管控: app, window, menu, menubar, dock, space, dialog
  • 要求：macOS 15+
• 参考
  • https://docs.openclaw.ai/platforms/mac/peekaboo
  • https://github.com/openclaw/openclaw/blob/main/skills/peekaboo/SKILL.md

brew install steipete/tap/peekaboo

# MCP
npx -y @steipete/peekaboo

# 截取全屏并在 Retina 缩放率下保存至桌面
peekaboo image --mode screen --retina --path ~/Desktop/screen.png

# 根据 Label 标签查找按钮并直接点击 (采集、识别、点击一步到位)
peekaboo see --app Safari --json-output | jq -r '.data.snapshot_id' | read SNAPSHOT
peekaboo click --on "Reload this page" --snapshot "$SNAPSHOT"

# 完全基于自然语言的一句话自动操作流
peekaboo "Open Notes and create a TODO list with three items"

# ~/.peekaboo/config.json
peekaboo config init

# openai|anthropic|grok|xai|gemini
peekaboo config add openai API_KEY

• PEEKABOO_AI_PROVIDERS
• OPENAI_API_KEY

{
  "mcpServers": {
    "peekaboo": {
      "command": "npx",
      "args": ["-y", "@steipete/peekaboo"],
      "env": {
        "PEEKABOO_AI_PROVIDERS": "openai/gpt-5.1,anthropic/claude-opus-4"
      }
    }
  }
}