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":"按钮文字"} |
Scan to join WeChat group