# Send Earl Display Control to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "earl-display-control", "name": "Earl Display Control", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/recozers/earl-display-control", "canonicalUrl": "https://clawhub.ai/recozers/earl-display-control", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/earl-display-control", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=earl-display-control", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "VisuoSpatialSketchpad/earl_api.py", "VisuoSpatialSketchpad/earl_mind.template.json", "VisuoSpatialSketchpad/remove_noise_take.py", "VisuoSpatialSketchpad/reorder_take.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/earl-display-control" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/earl-display-control", "downloadUrl": "https://openagent3.xyz/downloads/earl-display-control", "agentUrl": "https://openagent3.xyz/skills/earl-display-control/agent", "manifestUrl": "https://openagent3.xyz/skills/earl-display-control/agent.json", "briefUrl": "https://openagent3.xyz/skills/earl-display-control/agent.md" } } ``` ## Documentation ### Earl Display Control Skill for managing the VisuoSpatial Sketchpad — Earl's living-room TV dashboard. This covers starting the HTTP server, launching the kiosk browser, and updating earl_mind.json via the Python API. All file paths below use {baseDir} to mean this skill's root directory (the repo root containing VisuoSpatialSketchpad/). ### Quick Response Checklist Wake requests ("Earl wake up", "Could not sync", "Earl is sleeping") Start the local server (see Server Management) Launch the kiosk browser (see Launching the Kiosk) Confirm health: watch for GET /earl_mind.json ... 200 in the server log Content updates (mood, house stuff, hot takes, doodles, weather) Use the EarlMind API from {baseDir}/VisuoSpatialSketchpad/earl_api.py Relaunch the kiosk after changes if the display looks stale ### Server Management Start the HTTP server from the VisuoSpatialSketchpad directory: cd {baseDir}/VisuoSpatialSketchpad && python3 -m http.server 8000 Background the process so the shell prompt returns. ### Killing a stuck server macOS / Linux: lsof -ti:8000 | xargs kill -9 Windows (PowerShell): Get-Process -Id (Get-NetTCPConnection -LocalPort 8000).OwningProcess | Stop-Process -Force ### Launching the Kiosk macOS: open -a "Google Chrome" --args --kiosk http://localhost:8000/sketchpad.html If Chrome is unavailable, Safari works too: open -a Safari http://localhost:8000/sketchpad.html Windows (PowerShell): Start-Process msedge.exe '--kiosk http://localhost:8000/sketchpad.html --edge-kiosk-type=fullscreen' Linux: xdg-open http://localhost:8000/sketchpad.html Or for a true kiosk with Chromium: chromium-browser --kiosk http://localhost:8000/sketchpad.html Always relaunch after a wake cycle — the browser may cache the old page. ### EarlMind API Reference All methods live in {baseDir}/VisuoSpatialSketchpad/earl_api.py. Run from the VisuoSpatialSketchpad directory: from earl_api import EarlMind mind = EarlMind() Each mutating method auto-saves and bumps meta.last_updated / meta.update_count. ### Method Reference MethodPurposeKey Parametersset_mood(mood, energy, vibe, expression)Set Earl's mood and inner monologuemood: str, energy: 0-1 float, vibe: str, expression: strset_photo(url, caption)Set Earl's header photourl: str (URL or local path), caption: strpost_house_stuff(title, detail, priority, category, icon)Add a household reminderpriority: "high"/"medium"/"low", icon: emoji strresolve_house_stuff(item_id)Remove a resolved item by IDitem_id: str (e.g. "hs_a1b2c3")clear_house_stuff()Clear all house stuff items—update_room(room_id, status, notes, attention)Update a room's stateattention: 0-1 floatadd_room(room_id, name, x, y, icon, status, notes, attention)Add a new roomx, y: 0-1 normalized positionsweep()Log a full house sweep—hot_take(topic, take, heat, emoji)Add or update a hot takeheat: 0-1 float, updates if topic existsdrop_take(topic)Remove a hot take by topic—doodle(label, x, y, size, color, note)Place an emoji doodle on the sketchpadx, y: 0-1, size: px, color: hexsketch_note(text, x, y, size, color)Place a text note on the sketchpadSame as doodleclear_sketchpad()Wipe the sketchpad clean—learn_pattern(pattern, confidence, observations)Record a long-term patternconfidence: 0-1, observations: intsummary()Get a human-readable state summaryReturns strsnapshot()Get the raw mind dictReturns dict ### Common Examples # Set mood mind.set_mood("happy", energy=0.9, vibe="Sun's out, vibes are immaculate.") # Post a house reminder mind.post_house_stuff("Bins go out tonight", detail="Wednesday again.", priority="high", category="chores", icon="🗑️") # Drop a hot take mind.hot_take("Pineapple on pizza", "Controversial but I respect the audacity.", heat=0.6, emoji="🍕") # Doodle on the sketchpad mind.doodle("🌧️", x=0.3, y=0.2, size=30, note="Rain starting") # Log a pattern mind.learn_pattern("The cat sits by the window at 3pm", confidence=0.7, observations=5) ### Weather Update Run the weather helper to fetch live Open-Meteo data, update mood/energy, and drop a weather doodle: cd {baseDir}/VisuoSpatialSketchpad && python3 update_weather_ping.py ### earl_mind.json Schema The dashboard reads {baseDir}/VisuoSpatialSketchpad/earl_mind.json. Top-level structure: { "identity": { name, role, mood, energy (0-1), current_vibe, avatar_expression, photo, photo_caption } "spatial_awareness": { house_name, location: { latitude, longitude, timezone, temperature_unit, wind_speed_unit }, last_sweep, rooms: [...] } "house_stuff": { items: [{ id, title, detail, priority, category, icon }] } "earl_unplugged": [{ id, topic, take, heat (0-1), emoji, date }] "sketchpad": { canvas: [{ id, type ("doodle"|"note"), label, x, y, size, color, note }] } "long_term_patterns": [{ pattern, confidence (0-1), observations }] "meta": { schema_version, last_updated (ISO 8601), update_count } } If you edit JSON directly, always bump meta.last_updated and meta.update_count, and write with ensure_ascii=False, indent=2. ### Troubleshooting Server keeps dying — Check for duplicate python processes. On macOS/Linux: lsof -i:8000. On Windows: Get-Process python. Browser won't go fullscreen — Kill stray browser processes first. macOS: pkill -f "Google Chrome". Windows: taskkill /IM msedge.exe /F. Content not updating — Relaunch the kiosk to bust any cache. Verify the JSON saved correctly. Weather not working — Check that spatial_awareness.location.latitude and longitude are set (not 0.0) in earl_mind.json. Import error — Make sure you run Python from the VisuoSpatialSketchpad directory, or add it to sys.path. ### Tight Loop Restart server -> launch kiosk -> apply content changes -> relaunch kiosk if needed. Follow this every time the house texts "wake up". ## Trust - Source: tencent - Verification: Indexed source record - Publisher: recozers - Version: 0.1.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/earl-display-control) - [Send to Agent page](https://openagent3.xyz/skills/earl-display-control/agent) - [JSON manifest](https://openagent3.xyz/skills/earl-display-control/agent.json) - [Markdown brief](https://openagent3.xyz/skills/earl-display-control/agent.md) - [Download page](https://openagent3.xyz/downloads/earl-display-control)