One-click install
npx skills add https://github.com/234194027-cpu/xianclaw --skill kc-gui-234194027-cpu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kc-gui
Source: https://github.com/234194027-cpu/xianclaw/tree/main/resources/openclaw/config/skills/kc-gui
Command: npx skills add https://github.com/234194027-cpu/xianclaw --skill kc-gui-234194027-cpu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires winget, and includes scripts (resource) components.

What problem does it solve?

This Skill removes the need for manual clicking and form-filling when you must interact with specific Windows GUI applications through a desktop automation agent.

Core Features & Use Cases

  • Whitelisted Windows GUI automation: Automates visual desktop interactions (clicking, typing, navigating menus, reading on-screen text, and window management) using kc.exe, but only for a fixed, hardcoded application whitelist.
  • Task execution with safeguards: Enforces platform constraints (Windows only), integrity-level checks, and app-target validation, and provides guidance for long-running execution and troubleshooting.
  • Reliable GUI workflow orchestration: Uses a deterministic PowerShell wrapper to launch kc.exe with required process isolation behavior and built-in provisioning/synchronization of its configuration.

Use Case Example: You need to complete multi-step actions inside a whitelisted music/video app (e.g., navigate to a settings screen or perform a guided sequence) without manually operating the interface.

Quick Start

Ask the AI to run kc-gui on Windows to open a whitelisted application and perform your requested GUI actions, such as filling a specific settings screen and confirming the result on screen.

Frequently Asked Questions about kc-gui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Windows GUI tasks like clicking buttons and filling forms?

You can automate Windows GUI tasks by driving the bundled kc.exe desktop agent to interact with whitelisted applications. It handles clicking buttons, filling forms, reading dialogs, and navigating menus automatically.

Can I use this to automate any desktop application on Windows?

No, Windows GUI automation is restricted to a hardcoded application whitelist. The agent refuses non-whitelisted or system-level targets to ensure safe execution.

Do I need winget to set up the Windows desktop agent?

Yes, winget is required to provision the kc.exe desktop agent and its dependencies. This ensures the environment is correctly configured before executing automation tasks.

Why does my long-running GUI automation task get interrupted?

Long-running GUI automation tasks are managed by a PowerShell wrapper with a 600-second timeout. You must ensure your multi-step actions complete within this limit or adjust your workflow accordingly.

What are the limitations of using kc.exe for desktop automation?

kc.exe desktop automation is limited to Windows platforms and a fixed application whitelist. It cannot interact with system-level targets or non-whitelisted software.

Does Windows GUI automation work with screenshot reading and window management?

Yes, the Windows GUI automation agent supports screenshot reading and window management. It visually interacts with on-screen elements to navigate menus and manage application windows.