OpenClaw

Learn about actions >

• approve-nodes

  Approve all pending Node devices for connection to the Gateway

  Params

  • auto-approve boolean

    Automatically approve all pending nodes without confirmation

• backup

  Backup OpenClaw data (conversations, memory, configurations) to a timestamped compressed archive. The service will be gracefully stopped before backup and restarted after completion.

  Params

  • force boolean

    Force backup even if active processes are detected (not recommended)

  • output-path string

    Directory where the backup file will be created (default: /tmp)

  • wait-timeout integer

    Maximum seconds to wait for active processes to complete before backup (default: 30)

• get-gateway-token

  Retrieve the OpenClaw Gateway authentication token

  Params

  • format string

    Output format: 'text' (token only), 'json' (structured), or 'url' (tokenized dashboard URL)

• list-models

  List all configured AI models (primary and additional slots)

  Params

  • format string

    Output format: 'json' (structured details) or 'text' (simple list)

• upgrade

  Perform a system upgrade (apt-get full-upgrade) and reboot the system. When install-method=nvm and version="" or "latest", upgrade-node and reinstall-openclaw both default to true automatically — Node.js is upgraded to the latest patch of the configured major version and OpenClaw is reinstalled in the new version. Pass upgrade-node=false or reinstall-openclaw=false to suppress either step explicitly.

  Params

  • reinstall-openclaw string

    Force a clean reinstall of OpenClaw by uninstalling and reinstalling from scratch. Defaults to "auto": true when install-method=nvm and version="" or "latest", false otherwise. Set to "true" or "false" to override explicitly.

  • skip-reboot boolean

    Skip the scheduled reboot after the upgrade. Useful when only reinstalling OpenClaw without needing a full system reboot.

  • upgrade-node string

    Upgrade Node.js to the latest patch of the configured major version (node-version config, default 24) via nvm. Defaults to "auto": true when install-method=nvm and version="" or "latest", false otherwise. Because nvm global packages are per-node-version, OpenClaw is automatically reinstalled in the new version regardless of the reinstall-openclaw flag. Set to "true" or "false" to override.