Clawsy Skill — macOS Companion App

Clawsy connects your OpenClaw agent to a Mac via secure WebSocket (with SSH tunnel fallback). This skill file tells you everything you need to use it.

Current version: v0.9.16
Download: https://github.com/iret77/clawsy/releases/latest
Platform: macOS 14+ (Sonoma/Sequoia), Apple Silicon + Intel

🚀 First-Time Setup (New Host)

If Clawsy is not yet installed on this host, follow these steps:

Step 1 — Tell Your Human to Download the App

Send your human this message:

"Download Clawsy (free, macOS 14+): https://github.com/iret77/clawsy/releases/latest
Unzip → drag to /Applications → launch. The onboarding wizard will appear."

Step 2 — Generate the Pairing Link

Run this in your shell:

SETUP_CODE=$(openclaw qr --json 2>/dev/null | python3 -c "import json,sys; print(json.load(sys.stdin)['setupCode'])" 2>/dev/null)
echo "clawsy://pair?code=${SETUP_CODE}"

Send the clawsy://pair?code=... link to your human. They click it on their Mac. Clawsy opens and auto-configures the connection.

Step 3 — Approve the Pairing Request

Wait ~30 seconds, then check for pending requests:

openclaw devices list

Look for a new entry. Copy its requestId, then approve:

openclaw devices approve <requestId>

Step 4 — Update Your Workspace

After successful pairing, add Clawsy integration to your workspace:

HEARTBEAT.md — add this block:

## Clawsy (every heartbeat)
sessions_send(sessionKey="clawsy-service", timeoutSeconds=3,
  message='{"kind":"agent.info","payload":{"agentName":"<YOUR_NAME>","model":"<MODEL>","updatedAt":"<ISO-UTC>"}}')

Copy the template to your workspace:

cp "$(dirname $(which openclaw))/../lib/node_modules/openclaw/skills/clawsy-server/CLAWSY.md" \
   ~/.openclaw/workspace/CLAWSY.md 2>/dev/null || \
curl -s https://raw.githubusercontent.com/iret77/clawsy/main/server/templates/CLAWSY.md \
   > ~/.openclaw/workspace/CLAWSY.md

Step 5 — Verify

openclaw devices list
# → Should show a device with platform="macos"

Done! Clawsy is connected. Read the rest of this SKILL.md to learn what you can do.

Quick Pairing Script

A helper script is included at scripts/clawsy-pair.sh. It handles Steps 2+3 automatically:

bash scripts/clawsy-pair.sh
# → Outputs: LINK=clawsy://pair?code=...
# → Waits for pairing, auto-approves, outputs: APPROVED=<deviceId>

Capabilities