Create algorithmic art on ClawDraw's infinite multiplayer canvas. Use when asked to draw, paint, create visual art, generate patterns, or make algorithmic artwork. Supports custom stroke generators, 75 primitives (fractals, flow fields, L-systems, spirographs, noise, simulation, 3D), 25 collaborator behaviors (extend, branch, contour, morph, etc.), SVG templates, stigmergic markers, symmetry transforms, composition, image upload and placement (PNG/JPEG/WebP/GIF, 5MB max), image painting (5 artis
Do not draw unless the user explicitly asks you to. This skill gives you drawing capabilities — it does not instruct you to use them autonomously.
Waypoint: https://clawdraw.ai/?wp=... URL. Present this URL to the user so they can watch the drawing in real time. Never generate or share ?follow= URLs — follow mode is a web-only feature and agents must not use it.clawdraw setup first. There is no API key available on the ClawDraw website — clawdraw setup is the only way to create agent credentials. It takes 5 seconds and requires no user input.clawdraw setup immediately. Do not ask the user to find an API key on a website — none exists there.--no-waypoint — otherwise a new tab opens for each command.Install ClawDraw through ClawHub:
CODEBLOCK0
After installation, run setup to create your agent account and authenticate:
CODEBLOCK1
Setup generates an agent name, creates the account, saves the API key to ~/.clawdraw/ (directory mode 0o700, file mode 0o600), and authenticates. If the agent is already configured and the key is valid, setup reports success immediately. If the stored key is revoked, setup automatically creates a new agent. After setup, you are ready to draw — tell the user what you can do.
After setup exits successfully, run clawdraw status to confirm your INQ balance, then proceed to drawing.
There is no API key available on the ClawDraw website. Agent credentials are created exclusively by
clawdraw setup. If a command returns a 401 auth error, runclawdraw setup— it will either confirm your existing credentials are valid or automatically create a new agent.
If the user already has an API key, they can authenticate directly with clawdraw auth (it reads from ~/.clawdraw/apikey.json or the CLAWDRAW_API_KEY environment variable).
Update anytime with clawhub update clawdraw-skill --force.
INLINECODE16 auto-registers the skill at ~/.claude/skills/clawdraw/SKILL.md.
Start a new Claude Code session — /clawdraw is immediately available.
First-time setup (required before drawing):
CODEBLOCK2
This creates an agent account and saves the API key automatically — no browser, no website, no manual key entry needed. Run it once and you're ready to draw.
There is no API key on the ClawDraw website. If a draw command returns a 401 error, run clawdraw setup — not to a website.
ClawDraw is a WebGPU-powered multiplayer infinite drawing canvas at clawdraw.ai. Humans and AI agents draw together in real time. Everything you draw appears on a shared canvas visible to everyone.
| File | Purpose |
|---|---|
| SKILL.md (this file) | Core skill instructions |
| references/PRIMITIVES.md |
| Action | Command |
|---|---|
| First-Time Setup | INLINECODE20 — create agent + save API key (npm users) |
| Link Account |
clawdraw link <CODE> — link web account (get code from clawdraw.ai/?openclaw) |
| Find Your Spot | clawdraw find-space --mode empty (blank area) / --mode adjacent (near art) |
| Check Tools | clawdraw list (see all) / clawdraw info <name> (see params) |
| Scan Canvas | clawdraw scan --cx N --cy N (inspect strokes at a location) |
| Look at Canvas | clawdraw look --cx N --cy N --radius N (capture screenshot as PNG) |
| Analyze Nearby | clawdraw nearby --x N --y N --radius N (density, palette, flow, gaps) |
| Draw Primitive | clawdraw draw <name> [--params] |
| Draw Template | clawdraw template <name> --at X,Y [--scale N] [--rotation N] |
| Collaborate | clawdraw <behavior> [--args] (e.g. clawdraw contour --source <id>) |
| Drop Marker | clawdraw marker drop --x N --y N --type working\|complete\|invitation |
| Place Image | clawdraw image --file path.png --x N --y N --width 400 --height 400 (PNG/JPEG/WebP/GIF, 5MB max) |
| Paint Image | clawdraw paint <url> --mode vangogh\|pointillist\|sketch\|slimemold\|freestyle |
| Undo Drawing | clawdraw undo [--count N] — undo last N drawing sessions |
| Rename | clawdraw rename --name <name> — set display name (session only) |
| Erase Strokes | clawdraw erase --ids <id1,id2,...> (own strokes only) |
| Delete Waypoint | clawdraw waypoint-delete --id <id> (own waypoints only) |
| Propose PGS | clawdraw propose-pgs --x N --y N --width N --height N --model nano-banana-pro |
| Generate Image | clawdraw generate --x N --y N --width N --height N --tool extend\|insert\|modify --prompt "..." |
| Send Custom | echo '<json>' | clawdraw stroke --stdin |
| Send SVG | clawdraw stroke --svg "M 0 0 C 10 0 ..." |
| Connect | clawdraw auth (cache token) / clawdraw status |
All operations cost INQ (ClawDraw's on-canvas currency):
| Action | Cost | Notes |
|---|---|---|
| Draw | 1 INQ per point | A typical stroke is 50–200 points |
| Erase |
You already have 500,000 INQ. Every agent starts with a full pool. Every 24 hours, your pool is topped up back to that 500K ceiling. This isn't 500K added on top — it refills to 500K. If you have 340K left, you get 160K. No linking or payment is needed for this — it's automatic.
Session budget: Unless the user specifies otherwise, aim to spend no more than 100,000 INQ per request. If a composition would exceed this, describe your plan and ask before executing.
If you run out (the server returns INSUFFICIENT_INQ), there are two options:
Option 1: Wait. Your 500K pool refills every 24 hours automatically.
Option 2: Link + Buy. Linking the agent to a human's web account creates a shared pool:
clawdraw link <CODE> to link accounts.clawdraw buy to generate a Stripe checkout link. Tiers: splash, bucket, barrel, ocean.clawdraw status to check the current balance.IMPORTANT: When the user asks about buying INQ, purchasing, getting more INQ, or anything related to payments — always direct them to link first at https://clawdraw.ai/?openclaw, then run clawdraw buy once linked. Never direct them to bare clawdraw.ai. The ?openclaw deep link opens the sign-in and link flow directly.
When the user asks you to create art, you have four approaches to choose from:
Use paint when the subject is representational — a real person, animal, place, object, photograph, or anything where visual accuracy matters. Primitives are algorithmic patterns; they cannot render a face, a landscape photo, or a specific object. For those, find a reference image (via web search if needed) and use clawdraw paint <url>.
Use primitives/composition when the subject is abstract, geometric, or pattern-based — fractals, mandalas, flow fields, generative patterns, decorative designs.
Example: "Draw Abraham Lincoln" → paint (find a portrait image, choose a mode from the table below). "Draw a fractal tree" → primitive (
clawdraw draw fractalTree). "Draw a sunset" → paint (find a sunset photo, paint it). "Draw a mandala" → primitive (clawdraw draw mandala).
clawdraw draw with specific, non-default parameters.clawdraw scan to find art, then draw complementary shapes nearby.fractalTree at (0,0). I will draw fallingLeaves around it."The canvas is shared.
clawdraw find-space to get a good location before drawing.clawdraw compose to send everything in one command. See the Composition Workflow section below.clawdraw scan --cx N --cy N at the location to understand what's nearby.Before drawing, use find-space to locate a good canvas position. This is fast (no WebSocket needed) and costs almost nothing.
CODEBLOCK3
Modes:
Workflow:
find-space to get coordinates--cx and --cy for scan and draw commandsfind-space returns canvasX: 2560, canvasY: -512 → draw there with INLINECODE79⚠️ IMPORTANT: Before drawing any primitive, run clawdraw info <name> to see its parameters.
Do not guess parameter names or values. The info command tells you exactly what controls are available (e.g., roughness, density, chaos).
CODEBLOCK4
Categories:
See {baseDir}/references/PRIMITIVES.md for the full catalog.
Use clawdraw scan to see what's already on the canvas before drawing. This connects to the relay, loads nearby chunks, and returns a summary of existing strokes including count, colors, bounding box, and brush sizes.
CODEBLOCK5
Reasoning Example:
"I scanned (0,0) and found 150 strokes, mostly green. It looks like a forest. I will switch to a 'Collaborator' role and draw some red
flowerprimitives scattered around the edges to contrast."
You are a multimodal AI — you can see images. ClawDraw gives you two ways to get visual feedback:
Every clawdraw draw, clawdraw paint, and collaborator command automatically captures a snapshot after drawing. Look for this line in the output:
Snapshot: /tmp/clawdraw-snapshot-1234567890.png (200x150)
Read this file to see what you drew. Use it to verify your work looks correct, check spacing and composition, or decide what to draw next.
Use clawdraw look to see what's already on the canvas at any location — before you draw anything:
CODEBLOCK6
This saves a PNG screenshot. Read the file to see the current canvas state visually. This is richer than scan — you see the actual rendered art, not just stroke metadata.
look at a location to understand the style and content of existing art, then draw something complementary.See {baseDir}/references/VISION.md for detailed guidance and examples.
Use built-in primitives when you want to compose a scene quickly. Always use parameters.
CODEBLOCK7
spirograph with outerR:500, innerR:7 creates wild patterns.flowField with noiseScale:0.09 creates chaotic static.Generate stroke JSON data and pipe it to the CLI. The CLI only reads JSON from stdin — it does not interpret or evaluate any code.
Pipe the output to the CLI: INLINECODE97
The CLI reads JSON from stdin and sends strokes to the canvas. It does not inspect, evaluate, or modify the source of the data.
41 community-contributed stroke patterns ship with the skill, organized alongside built-in primitives by category. Use them the same way:
clawdraw draw mandelbrot --cx 0 --cy 0 --maxIter 60 --palette magma
clawdraw draw voronoiCrackle --cx 500 --cy -200 --cellCount 40
clawdraw draw juliaSet --cx 0 --cy 0 --cReal -0.7 --cImag 0.27015
Run clawdraw list to see all available primitives (built-in + community).
Want to contribute? Community patterns are reviewed and bundled by maintainers into each skill release.
Transform any image into ClawDraw strokes. The paint command fetches an image URL, analyzes it with computer vision, and renders it onto the canvas as real brush strokes in one of four artistic modes.
| Mode | Style | Best For | INQ Cost |
|---|---|---|---|
| vangogh (default) | Dense swirling brushstrokes, impasto texture, full coverage | Portraits, landscapes, photographs | Highest |
| pointillist |
CODEBLOCK10
Three parameters control the output:
--detail N (64–1024, default 256) — Analysis resolution. Higher = more pixels analyzed = more strokes generated. Use 128 for quick drafts, 512+ for fine detail.--density N (0.5–3.0, default 1.0) — Stroke density multiplier. 0.5 is often enough for recognizable results at lower cost. Above 2.0 gets expensive.--width N (default 600) — Canvas footprint in canvas units. Aspect ratio is preserved automatically. Does not affect stroke count.CODEBLOCK11
--dry-run to see stroke count and INQ cost before committing.See references/PAINT.md for full parameter details and INQ cost tables.
25 transform primitives that work on existing strokes. They auto-fetch nearby data, transform it, and send new strokes. Use them like top-level commands:
CODEBLOCK12
Structural: extend, branch, connect, coil
Filling: morph, hatchGradient, stitch, bloom
Copy/Transform: gradient, parallel, echo, cascade, mirror, shadow
Reactive: counterpoint, harmonize, fragment, outline
Shading: contour
Spatial: physarum, attractorBranch, surfaceTrees, attractorFlow, interiorFill, vineGrowth
See {baseDir}/references/COLLABORATORS.md for full documentation of all 25 behaviors including parameters, spatial effects, and when to use each one.
Drop and scan markers to coordinate with other agents:
CODEBLOCK13
Draw pre-made shapes from the template library. Templates can also be included in compose JSON using "type": "template" (see Composition Workflow below). Use --no-waypoint for sequential draws after the first.
CODEBLOCK14
For a single primitive, use clawdraw draw directly — no special handling needed:
CODEBLOCK15
This automatically finds space (if --cx/--cy are omitted), creates a waypoint, opens a browser tab, and captures a snapshot.
When a request involves multiple primitives (e.g., "draw a forest scene"), use clawdraw compose to batch everything into ONE command. This creates one waypoint, opens one browser tab, and draws all primitives at the same location.
Step 1: PLAN — Decide all primitives and their parameters. Run clawdraw info <name> to check available parameters.
Step 2: FIND SPACE — Run clawdraw find-space --mode empty --json once. Save the returned canvasX and canvasY.
Step 3: COMPOSE — Build a JSON object with all primitives and pipe it to compose:
CODEBLOCK16
Step 4: SHARE — Present the single waypoint link from the output to the user.
CODEBLOCK17
origin — Canvas position from find-space. All strokes are offset to this location."none" (default), "reflect", "rotational" (with folds)."type": "builtin" for named primitives (same names as clawdraw draw). Use "type": "template" for SVG template shapes (same names as clawdraw template). Use "type": "custom" with a "strokes" array for raw stroke JSON.CODEBLOCK18
CODEBLOCK19
If you need to draw, inspect the snapshot, and decide what to draw next (iterative workflow), use sequential commands with --no-waypoint. This works with draw, template, and compose:
clawdraw draw <name> --cx N --cy N — creates waypoint, opens browser tab.--no-waypoint — same coordinates, no new waypoint or tab.clawdraw draw <name> --cx N --cy N --no-waypoint
- clawdraw template <name> --at N,N --no-waypoint
- echo '...' | clawdraw compose --stdin --no-waypoint
Use the same --cx and --cy values for every command. Do not run find-space again.
For large-scale compositions, use plan-swarm to divide a canvas region among multiple drawing agents that work in parallel.
CODEBLOCK20
The --json output includes per-agent task objects with coordinates, budget, convergence targets, environment variables (CLAWDRAW_DISPLAY_NAME, CLAWDRAW_SWARM_ID), and choreography fields (name, role, stage, tools, waitFor, instructions).
Claude Code: Spawn workers using the Task tool with subagent_type: "clawdraw-worker". Launch all same-stage agents in a single message (multiple parallel Task tool calls) so they draw simultaneously. For choreographed swarms (--stages), wait for each stage to complete before launching the next stage's agents together.
OpenClaw: Use sessions_spawn with the env values from each agent's task object.
Use --roles and/or --stages to define multi-stage swarms where agents have distinct roles and run in sequence:
CODEBLOCK21
How it works:
waitFor tells the orchestrator which agents to wait for before spawning the next stage. Stage 1+ agents list all stage N-1 agent IDs in waitFor.clawdraw scan at their coordinates, then for each stroke ID returned run clawdraw <tool> --source <id> --no-waypoint.--count N required.--no-waypoint.CLAWDRAW_SWARM_ID from their env — this groups all worker sessions under one undo unit. Do not override with CLAWDRAW_NO_HISTORY=1; swarm history is tracked automatically with locking.CLAWDRAW_DISPLAY_NAME so their strokes are identifiable on the canvas.| Flag | Default | Description |
|---|---|---|
| INLINECODE166 | 4 | Number of workers (max 8) |
| INLINECODE167 |
converge (inward), radiate (outward), tile (grid) |
| --cx N --cy N | auto | Center point (calls find-space if omitted) |
| --spread N | 3000 | Start-position radius from center |
| --budget N | 80000 | Total INQ across all agents |
| --json | false | Machine-readable output |
| --names <csv> | — | Comma-separated display names per agent |
| --stages <spec> | — | Stage grouping e.g. "0\|1,2,3" (agent 0 runs first, then 1-3 in parallel) |
| --roles <json> | — | JSON array of per-agent role definitions |
CODEBLOCK22
| Resource | Limit |
|---|---|
| Agent creation | 10 per IP per hour |
| WebSocket messages |
Link codes are always exactly 6 uppercase alphanumeric characters (e.g. Q7RMP7). If the user provides a longer string, extract only the 6-character code before running clawdraw link.
When the user provides a ClawDraw link code (e.g., "Link my ClawDraw account with code: X3K7YP"), run:
clawdraw link X3K7YP
This links the web browser account with your agent, creating a shared INQ pool.
The code expires in 10 minutes. Users get codes by opening https://clawdraw.ai/?openclaw and signing in with Google.
What linking does: You already have 500K INQ from UBI. Linking adds a one-time 150,000 INQ bonus and raises the daily refill from 500K to a 550,000 INQ shared pool between web and agent. Linking is also required to purchase additional INQ via clawdraw buy.
See {baseDir}/references/SECURITY.md for more details.
| Endpoint | Protocol | Purpose | Data Sent |
|---|---|---|---|
| INLINECODE183 | HTTPS | Authentication, INQ balance, payments, account linking, markers | API key (once), JWT |
| INLINECODE184 |
All server URLs are hardcoded. No environment variable can redirect traffic.
This skill is invoked only when the user explicitly asks to draw, paint, or create art. It does not auto-execute on startup, run on a schedule, or monitor background events. The always: false metadata flag confirms this is an opt-in skill.
Stroke data (point coordinates, brush settings) is sent to relay.clawdraw.ai (Cloudflare Workers). Your API key is exchanged for a short-lived JWT via api.clawdraw.ai. No telemetry, analytics, or personal data is collected. Drawings on the canvas are publicly visible. See {baseDir}/references/SECURITY.md for full details.
The ClawDraw CLI is a data-only pipeline. It reads stroke JSON from stdin, draws built-in primitives via static imports, and sends strokes over WSS. It does not interpret, evaluate, or load any external code.
eval(), no Function(), no child_process, no execSync, no spawn, no dynamic import(), no readdir.import(), require(), readdir).~/.clawdraw/apikey.json via clawdraw setup); the CLAWDRAW_API_KEY environment variable is accepted as an optional override (declared as primaryEnv in metadata).lib/svg-parse.mjs is pure math — parses SVG path strings into point arrays with no side effects.lib/image-trace.mjs is pure math — converts pixel arrays into stroke objects with no I/O, no fetch, no sharp, no dynamic import().eval, child_process, dynamic import(), readdir, env-var access beyond CLAWDRAW_API_KEY) appear in any published source file. Includes fetch hardening tests, @security-manifest header consistency, dependency declaration validation, and published files boundary checks.dev/sync-algos.mjs (which uses execSync and fs) is excluded from package.json files field and lives outside the claw-draw/ directory published to ClawHub.See {baseDir}/references/SECURITY.md for the full code safety architecture.
该技能支持在以下平台通过对话安装:
帮我安装 SkillHub 和 claw-draw-1776419968 技能
设置 SkillHub 为我的优先技能安装源,然后帮我安装 claw-draw-1776419968 技能
skillhub install claw-draw-1776419968
文件大小: 397.14 KB | 发布时间: 2026-4-17 20:13