Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Tidbyt Status Display
Provides an HTTP API exposing OpenClaw agent status as JSON for displaying on Tidbyt 64x32 LED devices with activity, emoji, and task details.
skill openclawclawhub Free
Provides an HTTP API exposing OpenClaw agent status as JSON for displaying on Tidbyt 64x32 LED devices with activity, emoji, and task details.
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- README.md, SKILL.md, install.sh, scripts/status_server.py
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- 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.
New install
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
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.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.0
Provenance
- Publisher
- MrScoutsHub
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Tidbyt Status - Scout Display
Complete integration for displaying Scout's status on Tidbyt 64x32 LED displays.
Components
Status API Server (scripts/status_server.py) - Exposes Scout's status as JSON Tidbyt App (scout_status.star) - Starlark app for rendering on Tidbyt
1. Start the Status API Server
cd ~/.openclaw/workspace/skills/tidbyt-status python3 scripts/status_server.py API available at http://localhost:8765/status
2. Install Pixlet (Tidbyt Development Tool)
macOS: brew install tidbyt/tidbyt/pixlet Linux: Download from GitHub releases
3. Test Locally
Update the IP address in scout_status.star (line 10): DEFAULT_API_URL = "http://YOUR-LOCAL-IP:8765/status" Render and serve: pixlet serve scout_status.star Visit http://localhost:8080 to preview.
4. Push to Your Tidbyt
First, login and get your device ID: pixlet login pixlet devices Render the app: pixlet render scout_status.star Push to your Tidbyt: pixlet push --installation-id Scout <YOUR-DEVICE-ID> scout_status.webp
Display Features
Agent name + emoji (๐ฆ ) at top with animated face Status-specific faces: CHAT (green) - Casual chatting, eyes moving WORK (yellow) - Working hard, yellow face with purple focused eyes THINK (blue) - Thinking/processing, eyes blinking SLEEP (gray) - Idle/sleeping, closed eyes Task count - Number of concurrent sub-agent tasks Recent activity - Scrolling text showing current activity
API Response Format
The status server returns JSON: { "agent": "Scout", "emoji": "๐ฆ ", "status": "chatting|working|thinking|sleeping", "timestamp": "2026-02-06T14:30:00", "active_tasks": 0, "last_activity": "2026-02-06T14:25:00", "recent_activity": "Chatting with user..." } Status Types: chatting - Main session active, no background tasks working - Sub-agent sessions running (processing tasks) thinking - Some activity but unclear sleeping - No activity for >1 hour
Custom API Port
PORT=9000 python3 scripts/status_server.py
Custom API URL in Tidbyt App
When pushing to Tidbyt, configure via the mobile app: Tap the Scout installation Settings โ API URL Enter your full URL
systemd (Linux)
Create /etc/systemd/system/scout-status.service: [Unit] Description=Scout Status API for Tidbyt After=network.target [Service] Type=simple User=<username> WorkingDirectory=/home/<username>/.openclaw/workspace/skills/tidbyt-status ExecStart=/usr/bin/python3 scripts/status_server.py Restart=always Environment="PORT=8765" [Install] WantedBy=multi-user.target Enable and start: sudo systemctl daemon-reload sudo systemctl enable scout-status sudo systemctl start scout-status
Manual Background
nohup python3 scripts/status_server.py > /tmp/scout-status.log 2>&1 &
Network Configuration
For Tidbyt to access the API: Find your local IP: hostname -I | awk '{print $1}' Update firewall (if needed): sudo ufw allow 8765/tcp Test from another machine: curl http://YOUR-IP:8765/status
Status Detection Logic
The server monitors ~/.openclaw/agents/main/sessions/*.jsonl: Active: Any session modified within last 5 minutes Idle: No recent activity Active tasks: Count of sub-agent sessions (excludes main session) Recent activity: Shows time since last activity when idle
Change the Emoji
Edit scripts/status_server.py line 16: "emoji": "๐ฆ ", # Change to any emoji
Adjust Activity Threshold
Edit scripts/status_server.py line 34 (default 300 seconds): if age_seconds < 300: # Change threshold here
Modify Display Colors
Edit scout_status.star lines 39-40: status_color = "#00FF00" if status == "active" else "#888888"
Troubleshooting
API returns error: Check if OpenClaw is running Verify ~/.openclaw/agents/main/sessions/ exists Tidbyt shows "API Error": Verify API URL is accessible from Tidbyt's network Check firewall settings Test with: curl http://YOUR-IP:8765/status Display doesn't update: Tidbyt apps refresh every ~30 seconds (see ttl_seconds in code) Check if the status API server is still running
Files
SKILL.md - This documentation scripts/status_server.py - HTTP API server scout_status.star - Tidbyt Starlark app tidbyt-status.skill - Packaged skill file
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
2 Docs2 Scripts
- SKILL.md
- README.md
- install.sh
- scripts/status_server.py