Cua Docs

Install the Cua Driver agent skill

Install Cua Driver instructions for OpenClaw from ClawHub, or install them directly for another supported agent.

The Cua Driver agent skill teaches an agent how to choose tools, address windows and elements, preserve focus, and verify each action on macOS, Windows, or Linux.

The skill contains agent instructions. It does not install the cua-driver executable. Install Cua Driver on the same machine first.

Embedded skill over MCP

Cua Driver 0.28.0 and later also serves this release-matched skill from its stdio MCP endpoint. A client that supports MCP resources can read it without a filesystem install, but the client still decides whether reading a resource activates a skill. The direct install on this page remains the compatible path for native filesystem skill discovery.

Install from ClawHub#

Run the command from your OpenClaw workspace:

clawhub install @cua/driver

ClawHub installs the skill under the workspace's skills directory. The bundle contains the shared instructions and the macOS, Windows, and Linux guides, so the agent can read the guide for its current host.

Confirm that ClawHub tracks the install:

clawhub list

Restart OpenClaw or start a new agent session so it discovers the installed skill.

Verify Cua Driver#

Check the executable and host requirements separately:

cua-driver --version
cua-driver doctor

On macOS, also confirm that Cua Driver has Accessibility and Screen Recording permission:

cua-driver permissions status

Update or remove the ClawHub skill#

Update the installed skill:

clawhub update driver

Remove it from the current workspace:

clawhub uninstall driver

These commands change the agent instructions only. Use cua-driver update --apply to update the executable.

Install directly for another agent#

Cua Driver can install its bundled skill into supported agent directories without ClawHub:

cua-driver skills install
cua-driver skills status

With Cua Driver 0.28.0, fresh Codex and Claude Code installs may not create their skill directories until the first skill is installed. If skills status reports the relevant agent directory as absent, create only that client's parent directory and run the installer again:

# Codex
mkdir -p ~/.agents/skills
 
# Claude Code
mkdir -p ~/.claude/skills
 
cua-driver skills install

In Windows PowerShell, use New-Item -ItemType Directory -Force "$HOME\.agents\skills" for Codex or New-Item -ItemType Directory -Force "$HOME\.claude\skills" for Claude Code, then rerun cua-driver skills install.

Direct installation keeps only the current host's OS guide by default. Pass --all-platforms when the same skill directory must cover macOS, Windows, and Linux:

cua-driver skills install --all-platforms

Prime Agent is supported directly. When ~/.prime/agent/skills/ exists, cua-driver skills install links the pack there; Prime Agent also discovers the shared ~/.agents/skills/ location used by Codex. Run /reload in Prime Agent or start a new session after installing or updating the skill so it reloads the guidance.

cua-driver skills install auto-links Claude Code, Codex, Prime Agent, OpenClaw, OpenCode, Antigravity, and Hermes. Grok Bot is not in that list. On Grok Bot, save a private skill that follows the installed pack at ~/.cua-driver/skills/cua-driver. See Grok Bot.

Next steps#