Clawdbot Image Nodes

Configure Clawdbot AI assistant image nodes for displaying images and slideshows on remote screens.

Clawdbot Image Nodes Overview

Image nodes enable Clawdbot to display images on screens connected to remote devices. Use image nodes for photo frames, status displays, and visual notifications.

Features

FeatureDescription
Image DisplayShow images on screen
SlideshowsAutomatic image rotation
OverlaysText and graphic overlays
TransitionsSmooth transition effects
Remote ControlControl from anywhere

Configuration

Node Setup

{
  "node": {
    "name": "living-room-display",
    "capabilities": ["image"],
    "image": {
      "display": "default",
      "resolution": "1920x1080",
      "rotation": 0,
      "background": "#000000"
    }
  }
}

Display Options

OptionValuesDescription
resolutionWxHDisplay resolution
rotation0, 90, 180, 270Screen rotation
backgroundColorBackground color
scalingfit, fill, stretchImage scaling mode

Commands

Display Image

# Show single image
clawdbot nodes image living-room --file /path/to/photo.jpg

# Show from URL
clawdbot nodes image living-room --url "https://example.com/image.png"

# Clear display
clawdbot nodes image living-room --clear

Agent Commands

The agent can use image nodes:

"Display the weather forecast on the living room screen"

Slideshows

Configuration

{
  "image": {
    "slideshow": {
      "enabled": true,
      "interval": 30000,
      "shuffle": true,
      "transition": "fade",
      "transitionDuration": 1000
    }
  }
}

Slideshow Sources

{
  "image": {
    "slideshow": {
      "sources": [
        "/photos/family",
        "https://api.example.com/photos"
      ]
    }
  }
}

Transitions

TransitionDescription
fadeCrossfade
slideSlide in/out
zoomZoom effect
noneInstant switch

Overlays

Text Overlay

{
  "image": {
    "overlay": {
      "text": {
        "enabled": true,
        "content": "{{date}} {{time}}",
        "position": "bottom-right",
        "font": "Arial",
        "size": 24,
        "color": "#ffffff"
      }
    }
  }
}

Status Overlay

{
  "image": {
    "overlay": {
      "status": {
        "enabled": true,
        "showWeather": true,
        "showCalendar": true
      }
    }
  }
}

Supported Formats

FormatExtensionNotes
JPEG.jpg, .jpegMost common
PNG.pngTransparency support
GIF.gifAnimated support
WebP.webpModern format
BMP.bmpUncompressed

Multi-Display

Display Groups

{
  "nodes": {
    "groups": {
      "all-displays": ["living-room", "kitchen", "bedroom"]
    }
  }
}

Sync Displays

# Same image on all displays
clawdbot nodes image --group all-displays --file /path/to/image.jpg

# Sync slideshow
clawdbot nodes image --group all-displays --slideshow sync

Power Management

Display Sleep

{
  "image": {
    "power": {
      "sleepAfter": 3600000,
      "wakeOnActivity": true,
      "schedule": {
        "on": "07:00",
        "off": "23:00"
      }
    }
  }
}

Next Steps