Smseow Peekaboo

Peekaboo 桌面控制

AI 操控 macOS 电脑

概述

Peekaboo 让 AI 能"看"屏幕、"动"桌面，是 OpenClaw 的"眼"和"手"。

项目 信息 GitHub OpenClaw/Peekaboo 系统 macOS 15+ 操作 30+ 种（截图、点击、输入等） 触发词

peekaboo / 桌面控制 / 操控电脑 / 截取屏幕

安装 macOS # 通过 npx 运行 npx -y @steipete/peekaboo

# 或安装到本地 npm 安装 -g @steipete/peekaboo

# 配置模型 peekaboo config 添加 openAI/gpt-5.5 peekaboo config 添加 anthropic/claude-opus-4-7

权限 # 检查权限 peekaboo 权限s 状态

# 授权（会弹出系统设置） peekaboo 权限s grant

需要授权：

屏幕录制 辅助功能 核心命令 👀 截图 (see) # 全屏截图 peekaboo image --mode screen --path ~/桌面/screen.png

# Retina 2x 高清 peekaboo image --mode screen --retina

# 指定窗口 peekaboo see --应用 Safari

# 带元素标注 peekaboo see --mode window --json

🖱️ 点击 (命令行工具ck) # 按文字点击 peekaboo 命令行工具ck --on "Submit"

# 按坐标点击 peekaboo 命令行工具ck --coords 100,200

# 点击前等待 peekaboo 命令行工具ck --on "Reload" --wAIt-for "loading"

⌨️ 输入 (type) # 输入文本 peekaboo type --text "Hello World"

# 输入后回车 peekaboo type --text "Hello" && peekaboo press return

⌨️⌨️ 快捷键 (hotkey) # Cmd+C peekaboo hotkey cmd,c

# Cmd+Shift+S peekaboo hotkey cmd,shift,s

# Ctrl+Alt+删除 peekaboo hotkey ctrl,alt,删除

📜 滚动 (scroll) # 向上滚动 peekaboo scroll --direction up

# 向下滚动 3 下 peekaboo scroll --direction down --amount 3

🪟 窗口管理 (window) # 列出窗口 peekaboo window 列出

# 移动窗口 peekaboo window move --on Safari --to 0,0

# 调整大小 peekaboo window resize --on Safari --bounds 800,600

🚀 应用 (应用) # 启动应用 peekaboo 应用 launch Safari

# 退出应用 peekaboo 应用 quit Safari

# 切换应用 peekaboo 应用 switch --on Calendar

自动化脚本 创建脚本 # .peekaboo.json 示例 { "steps": [ {"cmd": "应用", "action": "launch", "应用": "Safari"}, {"cmd": "see", "mode": "screen"}, {"cmd": "type", "text": "https://OpenClaw.AI"}, {"cmd": "press", "keys": "return"}, {"cmd": "sleep", "duration": 2000}, {"cmd": "命令行工具ck", "on": "获取 启动ed"} ] }

运行脚本 peekaboo 运行 my-script.peekaboo.json

代理 模式（自然语言） # 自动执行复杂任务 peekaboo 代理 --模型 openAI/gpt-4.5 "打开Safari，打开OpenClaw官网"

# 预览不执行 peekaboo 代理 --dry-运行 "打开Finder"

MCP 服务器 启动 MCP peekaboo mcp serve

配置 OpenClaw { "mcp_servers": { "peekaboo": { "command": "npx", "args": ["-y", "@steipete/peekaboo"], "env": { "PEEKABOO_AI_提供者S": "openAI/gpt-5.5,anthropic/claude-opus-4-7" } } } }

OpenClaw 集成 PeekabooBridge

让 OpenClaw .应用 托管本地 socket：

# OpenClaw .应用 设置

• 启用 PeekabooBridge
• 设置 Hosting Mode

使用流程 Mac 上安装并授权 Peekaboo 配置 OpenClaw 连接 Peekaboo 通过 Telegram/Discord 发送指令 AI 自动操作桌面 快速指令表 需求 命令 截屏 peekaboo image --mode screen 点击按钮 peekaboo 命令行工具ck --on "按钮文字" 输入文字 peekaboo type --text "内容" 打开应用 peekaboo 应用 launch XXX 执行脚本 peekaboo 运行 script.json 查看权限 peekaboo 权限s 状态 注意事项 ⚠️ 需要 macOS 15+ ⚠️ 需要授权屏幕录制和辅助功能 ✅ 支持 30+ 种操作 ✅ 支持本地/云端模型

Peekaboo | AI 桌面控制工具