- name
- pc-control
- description
- PC控制工具，远程操控Windows电脑。当需要操作主人电脑时使用，如截屏、键鼠控制、文件操作、进程管理、浏览器自动化、Shell命令执行等。触发词：控制电脑、操作PC、截图、键盘、鼠标、文件管理、浏览器。
PC Control
Windows电脑控制工具，开箱即用，带完整安全防护。
快速安装
# 1. 安装 skill
clawhub install pc-control-luken
# 2. 安装依赖（Windows环境）
pip install -r skills/pc-control/scripts/requirements.txt
# 3. 配置 API Key（可选，推荐）
cd skills/pc-control/scripts
python generate_key.py # 生成新的 API Key
# 或直接编辑 security_config.json 设置你自己的 key
# 4. 启动 API 服务
python api.py安全认证
API 默认需要认证。调用时需要在 Header 中携带：
Authorization: Bearer <your_api_key>未携带 key 或 key 错误将返回 401/403。
代码文件
| 文件 | 说明 |
|---|---|
scripts/pc.py | CLI 命令行入口 |
scripts/api.py | HTTP API 服务 |
scripts/generate_key.py | API Key 生成器 |
scripts/security_config.json | 安全配置文件 |
scripts/modules/ | 功能模块（含安全沙箱） |
scripts/requirements.txt | Python 依赖 |
安全功能
- API Key 认证 — 全局 token 验证
- Shell 黑名单 — 拦截危险命令（del/shutdown/reg add等）
- 文件沙箱 — 禁止访问系统目录和危险文件类型
- 进程保护 — 系统关键进程无法被操作
- 操作日志 — 每次操作详细记录到
security.log
常用功能速查
| 功能 | 命令 |
|---|---|
| 截图 | GET /screenshot |
| 键盘按键 | POST /key/press {"key":"enter"} |
| 输入文本 | POST /key/type {"text":"..."} |
| 鼠标移动 | POST /mouse/move {"x":100,"y":200} |
| 鼠标点击 | POST /mouse/click {"x":100,"y":200} |
| 剪贴板读/写 | GET /clipboard/read / POST /clipboard/write |
| 进程列表 | GET /process/list |
| 结束进程 | POST /process/kill {"name":"notepad"} |
| 窗口列表 | GET /window/list |
| 关闭窗口 | POST /window/close {"title":"..."} |
| Shell执行 | POST /shell/run {"command":"...","shell":"powershell"} |
| 浏览器导航 | POST /browser/navigate {"url":"..."} |
| 浏览器点击 | POST /browser/click {"text":"按钮文字"} |