Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

chore(cua-driver): publish ClawHub skill under @cua (#2268)

Francesco Bonacciaeb79c67dfab
diff --git a/.github/workflows/clawhub-cua-driver.yml b/.github/workflows/clawhub-cua-driver.yml
index e80964a32b..4cbd39d058 100644
--- a/.github/workflows/clawhub-cua-driver.yml
+++ b/.github/workflows/clawhub-cua-driver.yml
@@ -16,7 +16,7 @@ on:
owner:
description: "ClawHub publisher handle"
required: true
- default: "f-trycua"
+ default: "cua"
type: string
confirm_mit0:
description: "Cua AI has authority to publish every bundled file under MIT-0"
@@ -39,7 +39,7 @@ jobs:
uses: openclaw/clawhub/.github/workflows/skill-publish.yml@b2f06028cff845974cfc9e528317ef879663935b
with:
skill_path: "libs/cua-driver/rust/Skills/cua-driver"
- owner: "f-trycua"
+ owner: "cua"
dry_run: true
ref: ${{ github.event.pull_request.head.sha }}
diff --git a/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx b/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
index d66dd8e772..788667ac26 100644
--- a/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
+++ b/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
@@ -77,6 +77,8 @@ cua-driver skills install
cua-driver skills status
```
+See [Install the Cua Driver agent skill](/how-to-guides/driver/install-agent-skill) for the ClawHub and direct-install paths.
+
## Cursor
Generate the Cursor snippet:
diff --git a/docs/content/docs/how-to-guides/driver/install-agent-skill.mdx b/docs/content/docs/how-to-guides/driver/install-agent-skill.mdx
new file mode 100644
index 0000000000..bd079cc010
--- /dev/null
+++ b/docs/content/docs/how-to-guides/driver/install-agent-skill.mdx
@@ -0,0 +1,82 @@
+---
+title: Install the Cua Driver agent skill
+description: Install Cua Driver instructions for OpenClaw from ClawHub, or install them directly for another supported agent.
+---
+
+import { Callout } from 'fumadocs-ui/components/callout';
+
+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.
+
+<Callout type="info">
+ The skill contains agent instructions. It does not install the `cua-driver` executable. [Install Cua Driver](/how-to-guides/driver/install) on the same machine first.
+</Callout>
+
+## Install from ClawHub
+
+Run the command from your OpenClaw workspace:
+
+```bash
+clawhub install @cua/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:
+
+```bash
+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:
+
+```bash
+cua-driver --version
+cua-driver doctor
+```
+
+On macOS, also confirm that Cua Driver has Accessibility and Screen Recording permission:
+
+```bash
+cua-driver permissions status
+```
+
+## Update or remove the ClawHub skill
+
+Update the installed skill:
+
+```bash
+clawhub update cua-driver
+```
+
+Remove it from the current workspace:
+
+```bash
+clawhub uninstall cua-driver
+```
+
+These commands change the agent instructions only. Use [`cua-driver update --apply`](/how-to-guides/driver/update) to update the executable.
+
+## Install directly for another agent
+
+Cua Driver can install its bundled skill into supported agent directories without ClawHub:
+
+```bash
+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:
+
+```bash
+cua-driver skills install --all-platforms
+```
+
+## Next steps
+
+- [Connect your agent to Cua Driver](/how-to-guides/driver/connect-your-agent): register the MCP server when the agent uses MCP.
+- [Keep Cua Driver running](/how-to-guides/driver/keep-running): configure the daemon to return after restarts.
+- [Agent action policy](/reference/cua-driver/action-selection-policy): review the behavior an agent wrapper should follow.
diff --git a/docs/content/docs/how-to-guides/driver/install.mdx b/docs/content/docs/how-to-guides/driver/install.mdx
index 1098c493f0..20dc3f5d57 100644
--- a/docs/content/docs/how-to-guides/driver/install.mdx
+++ b/docs/content/docs/how-to-guides/driver/install.mdx
@@ -119,6 +119,7 @@ cua-driver permissions status
## Next steps
+- [Install the Cua Driver agent skill](/how-to-guides/driver/install-agent-skill): add the cross-platform instructions from ClawHub or install them directly for another agent.
- [Keep Cua Driver running](/how-to-guides/driver/keep-running): configure autostart so the daemon comes back after reboots.
- [Connect Cua Driver to an MCP client](/how-to-guides/driver/connect-your-agent): register it with Claude Code, Cursor, Codex, and other clients.
- [Update Cua Driver](/how-to-guides/driver/update): check for new releases and apply them.
diff --git a/docs/content/docs/how-to-guides/driver/meta.json b/docs/content/docs/how-to-guides/driver/meta.json
index 393a3db7bf..65f092f9fe 100644
--- a/docs/content/docs/how-to-guides/driver/meta.json
+++ b/docs/content/docs/how-to-guides/driver/meta.json
@@ -2,6 +2,7 @@
"title": "Driver",
"pages": [
"install",
+ "install-agent-skill",
"run-in-macos-lume-vm",
"run-tests-in-macos-lume-vm",
"connect-your-agent",
diff --git a/libs/cua-driver/README.md b/libs/cua-driver/README.md
index c947e24267..85243bc9ea 100644
--- a/libs/cua-driver/README.md
+++ b/libs/cua-driver/README.md
@@ -56,7 +56,7 @@ Directly spawning a raw `cua-driver` binary outside `CuaDriver.app` without embe
## Publishing the agent skill to ClawHub
The canonical skill source is `rust/Skills/cua-driver`. It is published as one
-cross-platform ClawHub skill at `@f-trycua/cua-driver`; the bundle includes the
+cross-platform ClawHub skill at `@cua/cua-driver`; the bundle includes the
macOS, Windows, and Linux documents. Direct installs through `cua-driver skills
install` still keep only the host OS document unless `--all-platforms` is used.
@@ -75,7 +75,7 @@ all of the following:
in `rust/Skills/cua-driver/SKILL.md`.
3. Confirm the MIT-0 rights check in the workflow form.
4. Configure a repository Actions secret named `CLAWHUB_TOKEN` for a publisher
- that can release under the selected owner. The default owner is `f-trycua`.
+ that can release under the selected owner. The default owner is `cua`.
The workflow pins the ClawHub CLI, records the source repository, commit, ref,
and path, and uploads the JSON publish result as an Actions artifact. When a
@@ -87,10 +87,10 @@ After publishing, inspect and scan the exact version, then install it into an
empty work directory:
```bash
-npx --yes [email protected] inspect @f-trycua/cua-driver --version 0.8.3 --files
+npx --yes [email protected] inspect @cua/cua-driver --version 0.8.3 --files
npx --yes [email protected] scan --slug cua-driver --version 0.8.3 --update
npx --yes [email protected] --workdir /tmp/cua-driver-clawhub-smoke \
- install @f-trycua/cua-driver
+ install @cua/cua-driver
```
Confirm that `MACOS.md`, `WINDOWS.md`, and `LINUX.md` are present, run
diff --git a/libs/cua-driver/rust/Skills/cua-driver/README.md b/libs/cua-driver/rust/Skills/cua-driver/README.md
index c9f7055f5a..f6bbece372 100644
--- a/libs/cua-driver/rust/Skills/cua-driver/README.md
+++ b/libs/cua-driver/rust/Skills/cua-driver/README.md
@@ -129,7 +129,7 @@ The skill is a drop-in directory. Same shape on every platform.
**OpenClaw via ClawHub:**
```bash
-clawhub install @f-trycua/cua-driver
+clawhub install @cua/cua-driver
```
ClawHub installs the complete cross-platform bundle. The agent reads the shared