Skip to main content

clawdesk-daemon

The daemon crate provides the ability to run ClawDesk as a background service (daemon) without a graphical interface.

What It Does (Plain English)​

A daemon is a program that runs in the background, like a service. This crate lets you run ClawDesk without opening the desktop app — useful for servers, always-on setups, and headless deployments. The AI agents keep running, responding to messages from connected channels, even when nobody is looking at the screen.

Key Features​

  • Background operation — Runs without a GUI
  • Process management — Start, stop, restart via CLI
  • Auto-start — Configure to start on system boot
  • Health monitoring — Built-in health checks
  • Log management — Configurable logging to files

Usage​

# Start as daemon
clawdesk-cli daemon start

# Check status
clawdesk-cli daemon status

# Stop daemon
clawdesk-cli daemon stop

Architecture Role​

LayerPosition
ApplicationHeadless runtime

Dependencies​

  • clawdesk-gateway — Core server functionality
  • clawdesk-infra — Process and signal management