Skip to content

Background & Autostart ​

nextclaw start starts NextClaw, but it is not the same as host-level long-running management.

This page explains when you need background runtime and autostart, and how the NPM install path enables it explicitly.

When you need it ​

Consider autostart when:

  • you use NextClaw every day
  • you want it available after login
  • you do not want to restart it manually after reboot
  • you have connected channels or automations

NPM install does not register autostart ​

bash
npm i -g nextclaw

This only installs the CLI. It does not silently modify system startup entries.

If you want autostart, install the host-managed entry explicitly.

Enable by platform ​

Linux user service:

bash
nextclaw service install-systemd --user

Linux system service:

bash
sudo nextclaw service install-systemd --system

macOS:

bash
nextclaw service install-launch-agent

Windows:

bash
nextclaw service install-task

Check status ​

bash
nextclaw service autostart status
nextclaw service autostart doctor

When you do not need it ​

If you are only trying NextClaw or using the local UI occasionally, nextclaw start is enough.

Released under the MIT License.