SuperAPI AI 工具集

windows-app-mcp

部署与运维

查看项目

更新于 10-16 03:06

技能介绍

用途:在开发、调试或验证 OpenClaw Windows 应用时,使用同机本地 MCP 服务与该机客户端检查并调用运行中的应用。这是开发者与自动化通道,不是 OpenClaw 网关到节点的传输路径,两者不可混用:前者用于本机开发调试,后者用于智能体经网关配对使用 Windows 机器,验证依赖配对、白名单、重新审批、路由或 node.invoke 的行为时必须走网关路径。

主要能力:本地 MCP 暴露网关节点未公布的 app.* 命令,如 app.status、app.connection.status、app.navigate、app.menu、app.search、app.chat.send 等,也可直接调用共享 INodeCapability 的能力命令(system.、device.、screen.、camera.、location.、canvas.含 A2UI、browser.proxy、tts.、stt.、ollama.* 等)。用 winnode --list-tools 先发现当前实际可用工具,以实时 tools/list 响应为准;配置决定能力暴露。

使用方式:启动隔离开发应用,优先使用隔离托盘数据避免改动 %APPDATA%\OpenClawTray,可运行 .\run-app-local.ps1 -Isolated -AllowNonMain,复制启动器输出的数据目录并设为 OPENCLAW_TRAY_DATA_DIR。在 Permissions 中启用 Local MCP Server,支持仅 MCP 模式(EnableMcpServer=true 且 EnableNodeMode=false)。通过 winnode 调用,例如 winnode --command app.status --params '{}';参数必须是 JSON 对象,可用 @ 从文件加载大的 JSON;用 --invoke-timeout <ms> 限制长调用;--node 参数仅为命令行兼容而保留并被忽略。修改服务或协议形态时用原始 JSON-RPC 发送 initialize、tools/list、tools/call,可用 notifications/cancelled 配合请求 ID 验证取消。

限制与要求:winnode 只针对本地 Windows 应用,token 由所选托盘配置加载,不要放在命令行上。不得发布 bearer token、设置、网关记录、设备身份或含密钥的原始响应。新增或修改 Windows 节点命令需经共享 INodeCapability 注册、更新 McpToolBridge.CommandDescriptions 与 .agents\skills\winnode\SKILL.md、补充能力/MCP 桥/winnode 测试,并分别验证 winnode 与网关路径。

其他:该技能的完整静态命令参考位于 .agents\skills\winnode\SKILL.md,完整验证流程参见 .agents\skills\openclaw-proof-validation\SKILL.md。官方文档、收费与平台支持范围等细节暂未提供。