← Back to Skills Marketplace
40
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install smseow-peekaboo
Description
(Simon专属) 桌面控制 skill - AI 操控电脑。macOS 用 Peekaboo，Linux 用 MCP 工具。
README (SKILL.md)
桌面控制 (Desktop Control)
AI 操控电脑 - macOS / Linux / WSL2
概述
让 AI 能"看"屏幕、"动"桌面。
| 系统 | 工具 | GitHub |
|---|---|---|
| macOS 15+ | Peekaboo | openclaw/Peekaboo |
| Linux | Ubuntu Desktop Control MCP | charettep/... |
| WSL2 | python-xlib + X server | - |
触发词
桌面控制 / 操控电脑 / 截屏 / desktop
🖥️ macOS (Peekaboo)
安装
npx -y @steipete/peekaboo
# 授权
peekaboo permissions grant
命令
# 截图
peekaboo image --mode screen
# 点击
peekaboo click --on "按钮文字"
# 输入
peekaboo type --text "内容"
# 快捷键
peekaboo hotkey cmd,c
🐧 Linux (桌面 MCP)
方案1: Ubuntu Desktop Control MCP
# 安装
pip install mcp-desktop-control
# 运行
mcp-desktop-control
方案2: mcp-desktop-pro (跨平台)
# 安装运行
npx -y mcp-desktop-pro serve
# 截图
# mcp-desktop-pro screenshot
# 点击
# mcp-desktop-pro click --x 100 --y 200
方案3: kwin-mcp (KDE Wayland)
git clone https://github.com/bhyoo/kwin-mcp
cd kwin-mcp
python kwin-mcp.py
💻 WSL2 方案
1. 安装 X server (Windows)
下载安装 VcXsrv
2. WSL2 配置
# .bashrc 添加
export DISPLAY=localhost:0
# 安装依赖
sudo apt install python3-xlib flameshot scrot
3. Python 自动化
from pymouse import PyMouse
from pykeyboard import PyKeyboard
m = PyMouse()
k = PyKeyboard()
# 点击
m.click(100, 200)
# 输入
k.type_string("Hello")
# 快捷键
k.press_key('ctrl')
k.tap_key('c')
k.release_key('ctrl')
使用示例
macOS
你说：打开Safari去openclaw官网
我 → peekaboo app launch Safari
→ peekaboo type --text "openclaw.ai"
→ peekaboo press return
Linux
你说：截个图
我 → mcp-desktop-control screenshot
WSL2
你说：点击这个按钮
我 → 用坐标点击
注意事项
- ⚠️ macOS 需要 15+，授权辅助功能
- ⚠️ Linux 需要 X server 或 Wayland
- ⚠️ WSL2 需要 VcXsrv
桌面控制 | AI 操控电脑
Usage Guidance
Install only if you intentionally want an agent to operate your desktop. Verify the external tools first, grant permissions only during a trusted session, keep sensitive apps closed, require confirmation before any click/type/hotkey action, and stop or revoke desktop-control access when finished.
Capability Analysis
Type: OpenClaw Skill
Name: smseow-peekaboo
Version: 1.0.2
The skill enables full desktop automation (screenshots, input simulation, and UI interaction) across macOS, Linux, and WSL2 by installing third-party tools like @steipete/peekaboo and mcp-desktop-control. While these actions are consistent with the stated purpose of 'Desktop Control,' the broad system permissions required and the execution of external packages via npx/pip introduce high-risk capabilities. No evidence of intentional data exfiltration or malicious logic was found in SKILL.md.
Capability Assessment
Purpose & Capability
The stated purpose is coherent with the instructions, but the capability is high-impact: it lets an agent view the screen and operate the desktop across apps.
Instruction Scope
The instructions list direct screenshot, click, typing, and hotkey operations without guardrails such as app/path limits, confirmation before actions, or rollback guidance.
Install Mechanism
The skill is instruction-only, but it tells users to install and run unpinned third-party desktop-control tools via npx, pip, and git clone; this is purpose-aligned but should be verified before use.
Credentials
Desktop automation and screen capture can affect any visible local app or account session; the artifacts do not define containment such as a VM, test account, allowlist, or session-only use.
Persistence & Privilege
macOS accessibility permission and MCP desktop-control processes are expected for this kind of skill, but they are powerful privileges and should be granted only to trusted tools and revoked or stopped when finished.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smseow-peekaboo - After installation, invoke the skill by name or use
/smseow-peekaboo - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added Linux and WSL2 support alongside macOS; now supports cross-platform desktop control.
- Updated description and keywords to reflect broader OS compatibility and tools.
- Simplified and restructured documentation for clarity, separating instructions for macOS, Linux, and WSL2.
- Included setup steps and example commands for each supported platform.
- Clarified requirements and added notes on system dependencies for each environment.
v1.0.0
Initial release of smseow-peekaboo – AI-powered macOS desktop control skill.
- Enables AI to see and interact with your macOS desktop (macOS 15+ required)
- Provides 30+ operations: screenshot, click, type, scroll, window/app management
- Supports automation scripting and natural language control (Agent mode)
- Integrates with OpenClaw for remote/AI-driven control via Telegram/Discord
- Detailed command examples and setup instructions included in the documentation
Metadata
Frequently Asked Questions
What is Smseow Peekaboo?
(Simon专属) 桌面控制 skill - AI 操控电脑。macOS 用 Peekaboo，Linux 用 MCP 工具。 It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.
How do I install Smseow Peekaboo?
Run "/install smseow-peekaboo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Smseow Peekaboo free?
Yes, Smseow Peekaboo is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Smseow Peekaboo support?
Smseow Peekaboo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Smseow Peekaboo?
It is built and maintained by SMS (@smseow001); the current version is v1.0.2.
More Skills