zeroclaw service

Manage OS service lifecycle (systemd/launchd user service)

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

Linux (systemd)

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

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

macOS (launchd)

# View logs
tail -f ~/.zeroclaw/logs/daemon.stdout.log
tail -f ~/.zeroclaw/logs/daemon.stderr.log

Related

• Daemon Command
• Running Agents
• Monitoring