> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawcontrol.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# First-run Setup

This page describes the setup flow at `/setup`.

## Setup Checks

The setup page fetches `/api/system/init-status` and evaluates:

* Database initialization/migration readiness
* Workspace validation status
* OpenClaw CLI availability
* Gateway reachability (`reachable`, `auth_required`, or `unreachable`)

## Configuration Saved

Setup persists through `/api/config/settings`:

* `workspacePath`
* `gatewayHttpUrl` (loopback-only validation)
* `remoteAccessMode` (`local_only` or `tailscale_tunnel`)
* `setupCompleted`

## Access Mode Choice

* **Local only**: default and recommended.
* **Tailscale tunnel**: still local bind on host; remote via SSH forwarding only.
* Explicit warning is shown in setup UI: do not use `tailscale serve`.

## Completion Logic

* Dashboard readiness requires database `ok` and workspace `ok`.
* Setup completion flag is stored in settings.

## Last updated

2026-02-13

## Related pages

* [Settings and Remote Access](/features/settings-remote-access)
* [Config and Init](/api/config-init)
* [OpenClaw, Auth-required, and Workspace Errors](/operations/openclaw-auth-workspace-errors)