turix-mac – OpenClaw Skill

---

name: turix-mac description: Computer Use Agent (CUA) for macOS automation using TuriX. Use when you need to perform visual tasks on the desktop, such as opening apps, clicking buttons, or navigating UIs that don't have a CLI or API.

TuriX-Mac Skill

This skill allows Clawdbot to control the macOS desktop visually using the TuriX Computer Use Agent.

When to Use

• When asked to perform actions on the Mac desktop (e.g., "Open Spotify and play my liked songs").
• When navigating applications that lack command-line interfaces.
• For multi-step visual workflows (e.g., "Find the latest invoice in my email and upload it to the company portal").

Workflow

1. Preparation: Ensure the user has granted "Screen Recording" permission to /opt/homebrew/bin/node in System Settings.
2. Execution: Pass the user's task directly to the helper script.

Running TuriX

Invoke the helper script via exec. Pass the full task description as arguments. The script will automatically update the TuriX config.json with your task.

skills/local/turix-mac/scripts/run_turix.sh "Open System Settings and switch to Dark Mode"

💡 Tips for the Agent:

• Task Description: Be specific. Instead of "Open Chrome", use "Open Chrome and navigate to google.com".
• Dynamic Injection: You do NOT need to edit config.json manually; the script handles the JSON injection for you.
• Monitoring: Since this is a GUI-based task, keep the session open and use process log to check for status updates or errors like "NoneType" (permission issues).

Note: The process runs in the background. Monitor the output using the process tool if it doesn't return immediately.

Troubleshooting

• NoneType Error: If TuriX fails with AttributeError: 'NoneType' object has no attribute 'save', it usually means screen recording permission is missing or the process needs a restart.
• Path Issues: The script explicitly sets the PATH to include /usr/sbin so it can find the screencapture utility.

🐾 TuriX-Mac Clawdbot Skill

This skill allows Clawdbot to control your macOS desktop visually by integrating with the TuriX Computer Use Agent (CUA).

🚀 Overview

TuriX acts as the "eyes and hands" for Clawdbot. While Clawdbot is great at terminal and file operations, TuriX allows it to:

• Open and navigate GUI applications (Spotify, Chrome, System Settings, etc.)
• Click buttons and interact with complex UIs.
• Perform multi-step visual workflows.

It helps clawdbot complete the task automatically, makes clawdbot the real digital labour!

📦 Installation & Setup

1. TuriX Core Setup

Set up TuriX following the official repository: https://github.com/TurixAI/TuriX-CUA

conda activate your_env
pip install -r requirements.txt

2. Mandatory Permissions

macOS security requires explicit permission for background processes to capture the screen.

1. Screen Recording:
   • Go to System Settings > Privacy & Security > Screen Recording.
   • Add Terminal, VS COde.
   • Add /your_install_dir/bin/node (The binary running Clawdbot, example:/opt/homebrew/bin/node).
   • Ensure the toggle is ON.
2. Accessibility:
   • Go to System Settings > Privacy & Security > Accessibility.
   • Add Terminal, VS Code, Node, and /usr/bin/python3.

3. Skill Configuration

The skill uses a helper script to bridge Clawdbot and TuriX.

• Helper Script: scripts/run_turix.sh
• Skill Definition: SKILL.md

🛠 Usage

You can trigger this skill by asking Clawdbot to perform visual tasks:

"Use Safari to go to turix.ai, and sign up with Google account."

Clawdbot will execute the following in the background:

your_dir/clawd/skills/local/turix-mac/scripts/run_turix.sh

🔍 Troubleshooting

• AttributeError: 'NoneType' object has no attribute 'save': This means the screen capture failed. Usually fixed by adding node to Screen Recording permissions and running clawdbot gateway restart.
• screencapture: command not found: The script includes a PATH export to fix this, but ensure /usr/sbin is accessible.
• Permissions not sticking: Try removing and re-adding the application/binary in System Settings.