Skip to main content
Version: 0.8.5

First-run setup

1. Create the administrator​

The first-run path depends on the Engine host:

  • macOS or Windows app: open the app on the host computer and enter your display name. A new local personal installation does not require email or password. Before remote access or entering a Team Edition activation code, open System Settings → Users → Set up remote login and provide a real email address and a password of at least eight characters. Existing accounts keep their credentials.
  • Linux: use only the private administrator setup link printed by the installer. Run sudo clawuno open on the server to display it again, then create the administrator with a real email address and a password you can store securely.

Complete first-account setup before exposing an Engine to remote users. Do not share the Linux administrator setup link, its installation credential or the administrator account credentials.

2. Connect a model​

Choose the model connection that matches your account:

  • a supported API provider and API key;
  • ChatGPT subscription connection where offered;
  • a compatible custom or locally hosted model endpoint.

Run the connection test before continuing. A successful network request is not enough: Clawuno must also be able to use the selected model and response format.

See model configuration for provider presets, subscription sign-in and advanced settings.

Credentials are saved in the deployment you control. If you select a cloud model, prompts and the data you intentionally send are still processed under that provider's terms.

3. Enter the starter Workspace​

After connecting a model in first-run setup, Clawuno prepares a starter Workspace, arranges an Assistant Agent in it, and opens a new chat with that Agent. The chat is empty: suggested tasks only fill the composer; you decide whether to send them.

This automatic entry happens when you finish the guide, not on every later visit. If you choose to configure a model later, the starter Workspace and Agent are not prepared and this chat is not opened. Connect a model before running an Agent.

Create a small file as your first test, then open Files to confirm the output appears in the Workspace.

4. Meet Uno​

Uno is the system assistant, not the Agent assigned to every task. Open Uno when you want help navigating Clawuno, finding work, configuring an Agent, or understanding the current Workspace.

Try asking:

Show me where to create a new Agent and explain the settings I need for a research assistant.