clawd-presence

Clawdbot Tools
v1.0.1
Benign

Physical presence display for AI agents.

32.1K downloads2.1K installsby @voidcooks

Setup & Installation

Install command

clawhub install voidcooks/clawd-presence

If the CLI is not installed:

Install command

npx clawhub@latest install voidcooks/clawd-presence

Or install with OpenClaw CLI:

Install command

openclaw skills install voidcooks/clawd-presence

or paste the repo link into your assistant's chat

Install command

https://github.com/openclaw/skills/tree/main/skills/voidcooks/clawd-presence

What This Skill Does

Terminal-based presence display for AI agents. Shows a customizable monogram, status state, and current activity on a dedicated screen. The agent broadcasts state continuously so you can glance at it rather than checking chat.

A persistent display that updates in real time is faster than scrolling chat history to find the agent's last message.

When to Use It

  • Monitoring agent state while working in a separate window
  • Getting a visual alert when an agent needs human attention
  • Running multiple agents with distinct monogram identifiers
  • Tracking what a background agent is doing without opening chat
  • Setting up a dedicated screen for always-on agent visibility
View original SKILL.md file
# Clawd Presence

Terminal-based presence display for AI agents.

## Why

Chat has latency. A presence display inverts this - the agent broadcasts state continuously, you glance at it like a clock.

## Setup

```bash
# Configure (auto-detect from clawdbot or manual)
python3 scripts/configure.py --auto
# or
python3 scripts/configure.py --letter A --name "AGENT"

# Run display in dedicated terminal
python3 scripts/display.py
```

## Update Status

Call from your agent whenever starting a task:

```bash
python3 scripts/status.py work "Building feature"
python3 scripts/status.py think "Analyzing data"
python3 scripts/status.py idle "Ready"
python3 scripts/status.py alert "Need attention"
python3 scripts/status.py sleep
```

## States

| State | Color | Use |
|-------|-------|-----|
| `idle` | Cyan | Waiting |
| `work` | Green | Executing |
| `think` | Yellow | Processing |
| `alert` | Red | Needs human |
| `sleep` | Blue | Low power |

## Auto-Idle

Returns to idle after 5 minutes of no updates. Prevents stale states.

```bash
python3 scripts/configure.py --timeout 300  # seconds, 0 to disable
```

## Files

- `scripts/display.py` - Main display
- `scripts/status.py` - Update status
- `scripts/configure.py` - Settings
- `assets/monograms/` - Letter designs A-Z

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Monitoring agent state while working in a separate window

AGENT
  1. 1Monitoring agent state while working in a separate window
  2. 2Getting a visual alert when an agent needs human attention
  3. 3Running multiple agents with distinct monogram identifiers
  4. 4Tracking what a background agent is doing without opening chat
  5. 5Setting up a dedicated screen for always-on agent visibility
OUTPUT
Physical presence display for AI agents.

Share this skill

Security Audits

VirusTotalBenign
OpenClawBenign
View full report

These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.

Details

LanguageMarkdown
Last updatedFeb 26, 2026