PC Control

Windows电脑控制工具，开箱即用，带完整安全防护。

快速安装

bash

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 apikey>

未携带 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:按钮文字} |

详细文档

• - 完整API文档