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.

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

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

Next steps#