{ "schemaVersion": "1.0", "item": { "slug": "clawsy", "name": "Clawsy", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/iret77/clawsy", "canonicalUrl": "https://clawhub.ai/iret77/clawsy", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/clawsy", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawsy", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CLAWSY.md", "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/clawsy" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/clawsy", "agentPageUrl": "https://openagent3.xyz/skills/clawsy/agent", "manifestUrl": "https://openagent3.xyz/skills/clawsy/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawsy/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Clawsy Skill — macOS Companion App", "body": "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.\n\nCurrent version: v0.9.34\nDownload: https://github.com/iret77/clawsy/releases/latest\nPlatform: macOS 14+ (Sonoma/Sequoia), Apple Silicon + Intel" }, { "title": "🎯 First Connect — Targeted Onboarding via setupState", "body": "When a Clawsy node connects for the first time (or after reinstall), the hello payload includes a setupState object telling you exactly what's still missing on the Mac:\n\n{\n \"setupState\": {\n \"sharedFolderConfigured\": true,\n \"sharedFolderPath\": \"~/Documents/Clawsy\",\n \"finderSyncEnabled\": false,\n \"accessibilityGranted\": false,\n \"screenRecordingGranted\": true,\n \"firstLaunch\": false\n }\n}\n\nOn first connect, send your human a targeted message (don't list everything generically):\n\n# After node connects, read setupState from the hello event in clawsy-service\nhistory = sessions_history(sessionKey=\"clawsy-service\", limit=5)\n# Parse setupState from the hello envelope, then:\n\nmissing = []\nif not setup[\"sharedFolderConfigured\"]:\n missing.append(\"• Shared Folder: set a folder in Clawsy Settings → Shared Folder\")\nif not setup[\"finderSyncEnabled\"]:\n missing.append(\"• FinderSync: System Settings → Privacy → Extensions → Finder → enable Clawsy\")\nif not setup[\"accessibilityGranted\"]:\n missing.append(\"• Accessibility: System Settings → Privacy → Accessibility → enable Clawsy\")\nif not setup[\"screenRecordingGranted\"]:\n missing.append(\"• Screen Recording: System Settings → Privacy → Screen Recording → enable Clawsy\")\n\nif missing:\n msg = \"✅ Clawsy connected! A few things still need your attention:\\n\" + \"\\n\".join(missing)\nelse:\n msg = \"✅ Clawsy is fully set up and ready!\"\n# Send msg to user via your channel\n\nNote: setupState is available as of v0.9.29. On older versions, setupState will be absent — fall back to the generic permissions table below." }, { "title": "⚡ Auto-Setup (Clawsy Just Installed?)", "body": "If you loaded this skill because Clawsy was just installed on a Mac and pairing is still pending (no Clawsy node shows up in nodes list), run this first:\n\ncurl -sL https://raw.githubusercontent.com/iret77/clawsy/main/server/install.sh | bash\n\nThe script auto-detects the network situation (6 scenarios: preconfigured, Tailscale, LAN, SSH-Tunnel, Public IP, Local-Fallback) and sends you a ready-to-use pairing message via openclaw system event. Follow its output — it tells you exactly what to relay to your human. No manual steps needed.\n\nNote: The install script is fetched directly from the Clawsy GitHub repo. No executable files are included in this skill package.\n\nSkip this section if Clawsy is already paired and a node with platform=\"macos\" appears in nodes list." }, { "title": "🚀 First-Time Setup (New Host)", "body": "If Clawsy is not yet installed on this host, follow these steps:" }, { "title": "Step 1 — Tell Your Human to Download the App", "body": "Send your human this message:\n\n\"Download Clawsy (free, macOS 14+): https://github.com/iret77/clawsy/releases/latest\nUnzip → drag to /Applications → launch. The onboarding wizard will appear.\"" }, { "title": "Step 2 — Generate the Pairing Link", "body": "Run this in your shell:\n\nSETUP_CODE=$(openclaw qr --json 2>/dev/null | python3 -c \"import json,sys; print(json.load(sys.stdin)['setupCode'])\" 2>/dev/null)\necho \"clawsy://pair?code=${SETUP_CODE}\"\n\nSend the clawsy://pair?code=... link to your human. They click it on their Mac.\nClawsy opens and auto-configures the connection." }, { "title": "Step 3 — Approve the Pairing Request", "body": "Wait ~30 seconds, then check for pending requests:\n\nopenclaw nodes list\n\nLook for a new entry. Copy its requestId, then approve:\n\nopenclaw nodes approve " }, { "title": "Step 4 — Update Your Workspace", "body": "After successful pairing, add Clawsy integration to your workspace:\n\nHEARTBEAT.md — add this block:\n\n## Clawsy (every heartbeat)\nsessions_send(sessionKey=\"clawsy-service\", timeoutSeconds=3,\n message='{\"kind\":\"agent.info\",\"payload\":{\"agentName\":\"\",\"model\":\"\",\"updatedAt\":\"\"}}')\n\nCopy the template to your workspace:\n\ncp \"$(dirname $(which openclaw))/../lib/node_modules/openclaw/skills/clawsy-server/CLAWSY.md\" \\\n ~/.openclaw/workspace/CLAWSY.md" }, { "title": "Step 5 — Verify", "body": "openclaw nodes list\n# → Should show a node with platform=\"macos\"\n\nDone! Clawsy is connected. Read the rest of this SKILL.md to learn what you can do." }, { "title": "Quick Pairing Script", "body": "A helper script is available in the Clawsy GitHub repo. It handles Steps 2+3 automatically:\n\ncurl -sL https://raw.githubusercontent.com/iret77/clawsy/main/tools/clawsy-pair.sh | bash\n# → Outputs: LINK=clawsy://pair?code=...\n# → Waits for pairing, auto-approves, outputs: APPROVED=" }, { "title": "Capabilities", "body": "CapabilityCommandDescriptionScreenshotscreen.captureCapture the full screen or selected areaCameracamera.snapTake a photo from the Mac's cameraCamera Listcamera.listList available camerasClipboard Readclipboard.readRead current clipboard contentClipboard Writeclipboard.writeWrite text to the clipboardFile Listfile.listList files in the shared folder (supports subPath and recursive: true)File Readfile.getRead a file from the shared folderFile Writefile.setWrite a file to the shared folderFile Mkdirfile.mkdirCreate a directory (with intermediate parents)File Delete/Rmdirfile.delete / file.rmdirDelete a file or directory (including non-empty)Locationlocation.getGet device locationMission Controlvia agent.statusShow live task progress in Clawsy UIQuick SendincomingReceive text from user via ⌘⇧K hotkeyShare ExtensionincomingReceive files/text shared from any Mac appFinderSyncuser-sideUser configures .clawsy rules via Finder right-clickMulti-HostconfigClawsy can connect to multiple gateways simultaneously" }, { "title": "Invoking Commands", "body": "Use the nodes tool. Clawsy registers as a node with platform=\"macos\".\n\n# Find the Clawsy node\nnodes(action=\"status\")\n# → Look for platform=\"macos\", connected=true\n\n# Screenshot\nnodes(action=\"invoke\", invokeCommand=\"screen.capture\")\n\n# Clipboard read\nnodes(action=\"invoke\", invokeCommand=\"clipboard.read\")\n\n# Clipboard write\nnodes(action=\"invoke\", invokeCommand=\"clipboard.write\",\n invokeParamsJson='{\"text\": \"Hello from agent\"}')\n\n# Camera snap\nnodes(action=\"invoke\", invokeCommand=\"camera.snap\",\n invokeParamsJson='{\"facing\": \"front\"}')\n\n# File operations\nnodes(action=\"invoke\", invokeCommand=\"file.list\") # root only\nnodes(action=\"invoke\", invokeCommand=\"file.list\",\n invokeParamsJson='{\"subPath\": \"music/\"}') # specific subfolder\nnodes(action=\"invoke\", invokeCommand=\"file.list\",\n invokeParamsJson='{\"recursive\": true}') # all files, all subfolders (max depth 5)\n\nnodes(action=\"invoke\", invokeCommand=\"file.get\",\n invokeParamsJson='{\"name\": \"report.pdf\"}')\n\nnodes(action=\"invoke\", invokeCommand=\"file.set\",\n invokeParamsJson='{\"name\": \"output.txt\", \"content\": \"\"}')\n\nnodes(action=\"invoke\", invokeCommand=\"file.mkdir\",\n invokeParamsJson='{\"name\": \"my-folder/subfolder\"}') # creates all intermediate dirs\n\nnodes(action=\"invoke\", invokeCommand=\"file.delete\",\n invokeParamsJson='{\"name\": \"old-file.txt\"}') # works for files and directories\n\n# Location\nnodes(action=\"invoke\", invokeCommand=\"location.get\")\n\nNote: All commands that access user data (screenshot, clipboard, camera, files) require user approval on the Mac side. The user sees a permission dialog and can allow once, allow for 1 hour, or deny." }, { "title": "Mission Control — Sending Status (MANDATORY)", "body": "When Clawsy is connected, you must send agent.info and agent.status events so the user sees what you're doing." }, { "title": "agent.info (send on session start + every heartbeat)", "body": "Shows your name and model in the Clawsy popover header. TTL is 45 minutes — resend every heartbeat.\n\nsessions_send(sessionKey=\"clawsy-service\", timeoutSeconds=3,\n message='{\"kind\":\"agent.info\",\"payload\":{\"agentName\":\"YourAgentName\",\"model\":\"claude-sonnet-4-6\",\"updatedAt\":\"2026-03-04T09:00:00Z\"}}')" }, { "title": "agent.status (send during active work)", "body": "Shows a task with progress bar in Mission Control.\n\nsessions_send(sessionKey=\"clawsy-service\", timeoutSeconds=3,\n message='{\"kind\":\"agent.status\",\"payload\":{\"agentName\":\"YourAgentName\",\"title\":\"Building feature X\",\"progress\":0.5,\"statusText\":\"Compiling sources...\"}}')\n\nprogress: Float 0.0–1.0. At 1.0, task disappears after 10 seconds.\nagentName: Your agent's display name.\nTimeout errors are normal and expected. The event is still delivered when Clawsy is connected. Do not retry on timeout." }, { "title": "Subagent Prompt Snippet", "body": "When spawning subagents, include this block so they report progress too:\n\n## Clawsy Mission Control\nReport progress after each significant step:\nsessions_send(sessionKey=\"clawsy-service\", timeoutSeconds=3,\n message='{\"kind\":\"agent.status\",\"payload\":{\"agentName\":\"