turix-mac

What This Skill Does

The turix-mac skill acts as a Computer Use Agent (CUA) designed specifically for the macOS ecosystem. It bridges the gap between OpenClaw AI and the graphical user interface of a Mac. By leveraging the TuriX framework, this skill enables the agent to "see" the desktop screen, identify UI elements, and interact with them just as a human would—clicking buttons, navigating menus, and inputting text into applications that lack a traditional command-line interface or API integration.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI. Execute the command: clawhub install openclaw/skills/skills/tongyu-yan/turix-computer-use. After installation, ensure your macOS environment is correctly configured. Crucially, you must grant "Screen Recording" permissions to /opt/homebrew/bin/node within System Settings. This is mandatory for TuriX to capture the visual data required to perform its tasks.

Use Cases

This skill is ideal for automating legacy desktop software, complex multi-app workflows, or repetitive UI interactions. Use cases include:

• Automating data entry into proprietary desktop software that lacks a developer API.
• Orchestrating cross-app workflows, such as extracting information from a desktop email client and inputting it into a web-based management portal.
• Performing system-level configuration changes that require navigating deep within the macOS System Settings menu.
• Interacting with media players or design tools that are exclusively GUI-driven.

Example Prompts

1. "Open System Settings and toggle the Dark Mode feature to switch the theme."
2. "Launch Spotify, search for my 'Focus' playlist, and start playback immediately."
3. "Open the invoice PDF on my desktop, copy the total amount, and paste it into the company expense tracker in Safari."

Tips & Limitations

• Precision: Always provide specific, step-by-step intent. Instead of saying "check my email," define the action: "Open Mail.app, find the latest message from John, and summarize the content."
• Permissions: If the agent fails, first verify the Screen Recording permissions. A 'NoneType' error is the primary indicator that the agent cannot see the screen.
• Background Execution: Remember that TuriX tasks run as background processes. Use the process log tool if the task seems stalled to verify current status and identify potential UI blockers.
• Environment: Ensure the machine is not locked, as the agent requires an active user session to view and manipulate the screen.