Summary

The onboarding wizard does not install a Systemd service in Ubuntu. During the Systemd step, it prints: Systemd user services are unavailable. Skipping lingering checks and service install.

This is because the isSystemdUserServiceAvailable function is throwing this error:

Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined (consider using --machine=<user>@.host --user to connect to bus of other user)

Steps to reproduce

Just run the onboarding wizard on Ubuntu 22.04.

Expected behavior

Systemd is obviously installed on my OS.

Actual behavior

Gateway service check failed: Error: systemctl --user unavailable: Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined (consider using --machine=<user>@.host --user to connect to bus of other user)

Environment

• Clawdbot version: 2026.1.23-1
• OS: Ubuntu 22.04
• Install method (pnpm/npx/docker/etc): npm

Logs or screenshots

Gateway service check failed: Error: systemctl --user unavailable: Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined (consider using --machine=<user>@.host --user to connect to bus of other user)