A comprehensive Linux system control suite for managing desktop windows, processes, hardware settings, serial devices, and IoT platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linux-system-controller
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install linux-system-controller using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is System Controller?
System Controller is a powerful integration for Openclaw Skills designed to provide a unified interface for Linux system management. It bridges the gap between natural language intent and low-level system execution, allowing users to control their desktop environment, hardware components, and connected devices through a modular Python-based architecture.
By leveraging industry-standard tools like xdotool, wmctrl, and Tesseract OCR, this skill empowers AI agents to interact with the physical and digital world. Whether you are automating GUI tasks, monitoring system processes, or communicating with an Arduino via serial ports, System Controller provides the necessary scripts to handle complex workflows safely and efficiently.
System Controller Use Cases
- Automating desktop window layouts and application positioning
- Managing system resources by monitoring and killing runaway processes
- Controlling hardware parameters like screen brightness, system volume, and power states
- Interfacing with microcontrollers such as Arduino or ESP32 via serial communication
- Integrating with Home Assistant or Mijia for smart home automation
- Performing GUI automation using OCR and visual template matching for legacy software
How System Controller Works
- The system receives a natural language request from the user to perform a specific system task.
- The request is processed to identify the required control module among the six available specialized scripts.
- The AI agent checks for necessary prerequisites and ensures the command follows strict safety rules (e.g., requesting confirmation for destructive actions).
- The chosen script (e.g., window_manager.py or hardware_controller.py) executes the specific CLI command with the required flags.
- The skill interacts directly with Linux system utilities or hardware interfaces to fulfill the request.
- Feedback is returned to the user, confirming the success of the operation or providing the requested system data.
System Controller Setup
To get started with this module in Openclaw Skills, ensure your Linux environment is prepared with the following dependencies:
# Update system and install required CLI utilities
sudo apt-get update && sudo apt-get install -y xdotool wmctrl tesseract-ocr alsa-utils
# Install Python dependencies
pip install pyserial>=3.5 requests>=2.28.0 pyautogui>=0.9.54 pillow>=9.0.0 pytesseract>=0.3.10
System Controller Data Schema & Taxonomy
System Controller organizes its functionality into modular scripts located within the scripts/ directory. Each script acts as an independent CLI tool with a specific domain of responsibility:
| Module | Script Name | Functionality |
|---|---|---|
| Window Manager | window_manager.py |
Desktop window control (resize, move, focus) |
| Process Manager | process_manager.py |
System process management and monitoring |
| Hardware Controller | hardware_controller.py |
Hardware settings (Volume, Brightness, Power, Network) |
| Serial Communication | serial_comm.py |
Arduino and serial device interaction |
| IoT Controller | iot_controller.py |
Home Assistant and REST API integrations |
| GUI Controller | gui_controller.py |
Mouse/Keyboard automation, OCR, and Screenshots |
System Controller Advanced Features
- Visual OCR support for extracting text from specific screen regions or active windows
- Fail-safe protection for GUI automation: move the mouse to any corner to abort operations
- Automated serial port detection and baud rate monitoring for embedded development
- Full Home Assistant REST API support for triggering complex smart home scenes
- Intelligent visual template matching to identify and click icons on screen without coordinates
- Multi-module fallback logic for handling unknown devices via USB or network discovery
SKILL.md
Loading
Related Openclaw Skills
Skill Analyst
A professional evaluation tool for analyzing, comparing, and auditing AI agent skills before installation or publication.
Kyvio Integration for AI Agents
A powerful integration skill that enables AI agents to manage Kyvio business data, including subscribers, funnels, and membership courses, through a secure proxy layer.
FoolClaw
FoolClaw is a mischievous Openclaw Skills extension that allows AI agents to perform harmless local pranks and maintain a playful background presence on your system.
Building a Referral Program
A strategic framework for designing and launching high-conversion referral programs that drive organic word-of-mouth growth.
Build in Public Strategy
A strategic framework for leveraging transparency and public progress-sharing to drive growth and build a loyal audience.
HNA 666Plus Flight Checker
An automated browser-based tool to scan Hainan Airlines 666Plus benefit availability for round-trip flights departing from Beijing.
Featured*
