Skip to main content
The zeroclaw service command manages ZeroClaw as an OS-level service with automatic startup.

​
Overview

Install ZeroClaw as a systemd (Linux) or launchd (macOS) user service for:
  • Automatic startup on boot
  • Background execution
  • Log management
  • Process supervision

​
Subcommands

​
install

Install ZeroClaw as a user service. 
zeroclaw service install
Creates service file at:
  • Linux: ~/.config/systemd/user/zeroclaw.service
  • macOS: ~/Library/LaunchAgents/com.zeroclaw.daemon.plist

​
start

Start the ZeroClaw service. 
zeroclaw service start

​
stop

Stop the ZeroClaw service. 
zeroclaw service stop

​
restart

Restart the ZeroClaw service. 
zeroclaw service restart

​
status

Check service status. 
zeroclaw service status
Shows:
  • Running state (active/inactive)
  • PID
  • Uptime
  • Recent log entries

​
uninstall

Remove the service installation. 
zeroclaw service uninstall

​
enable

Enable auto-start on boot. 
zeroclaw service enable

​
disable

Disable auto-start on boot. 
zeroclaw service disable

​
Options

​
--service-init
string
default:"auto"
Init system to use: auto (detect), systemd, or openrc

​
Examples

​
Complete Setup

# Install and start
zeroclaw service install
zeroclaw service enable
zeroclaw service start

# Check status
zeroclaw service status

​
View Logs

# Follow logs
journalctl --user -u zeroclaw.service -f

# Last 100 lines
journalctl --user -u zeroclaw.service -n 100

Build docs developers (and LLMs) love

Get started for freeTalk to us