Smseow Peekaboo

桌面控制 (Desktop Control)

AI 操控电脑 - macOS / Linux / WSL2

---

概述

让 AI 能"看"屏幕、"动"桌面。

---

触发词

桌面控制 / 操控电脑 / 截屏 / 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 操控电脑