Skip to content
UURoute

OpenClaw Integration

This guide shows how to configure OpenClaw to use model capabilities through the unified UURoute API.

Prerequisites

Section titled “Prerequisites”

Before you start, make sure you have:

  1. OpenClaw installed

    OpenClaw recommends Node 24, or Node 22.14 and later. The installer script can handle Node setup automatically.

    macOS, Linux, or WSL2:

    Terminal window
    curl -fsSL https://openclaw.ai/install.sh | bash

    Windows PowerShell:

    Terminal window
    iwr -useb https://openclaw.ai/install.ps1 | iex

  2. An UURoute API key

    Sign in to the UURoute platform, create an API key, and copy it.

Run the OpenClaw Onboarding Wizard

Section titled “Run the OpenClaw Onboarding Wizard”

Start the onboarding wizard:

Terminal window
openclaw onboard

During onboarding, configure OpenClaw as follows.

1. Select a Model Provider

Section titled “1. Select a Model Provider”

Choose Custom Provider or Other (OpenAI Compatible API).

2. Enter UURoute Provider Details

Section titled “2. Enter UURoute Provider Details”

Use the following UURoute API settings:

FieldValue
Base URLhttps://portal-api.stag.uuroute.net/v1
API key inputChoose Enter API key directly, then paste your UURoute API key

After successful verification, OpenClaw generates an endpoint ID, such as custom-api-uuroute-ai, and continues to the next step.

3. Set a Model Alias

Section titled “3. Set a Model Alias”

Optionally enter a memorable alias, such as uuroute, to make the provider easier to select later.

Press Enter to skip this step if you do not need an alias.

4. Select a Default Model ID

Section titled “4. Select a Default Model ID”

Enter the model ID you want to use through UURoute, for example:

gpt-4.1

or:

claude-3-haiku

When you see Verification successful, OpenClaw has connected to UURoute successfully, and the Base URL and API key are valid.

5. Skip Optional Skill Dependencies

Section titled “5. Skip Optional Skill Dependencies”

When OpenClaw shows the skill dependency list, select Skip for now unless you specifically need those skills.

6. Skip Optional External API Keys

Section titled “6. Skip Optional External API Keys”

OpenClaw may ask for additional keys such as GOOGLE_PLACES_API_KEY for specific skills.

These keys are optional and are not required for UURoute model chat. You can choose No or press Enter to skip them.

7. Choose a Startup Mode

Section titled “7. Choose a Startup Mode”

Select Hatch in TUI to start OpenClaw in the terminal UI. This is the recommended command-line mode.

Verify the Integration

Section titled “Verify the Integration”

In the OpenClaw TUI chat interface, check the bottom status bar. You should see a provider and model similar to:

custom-api-uuroute-ai/gpt-4.1

This means OpenClaw is using gpt-4.1 through UURoute.

Send a test message, such as:

hello

If OpenClaw returns a model response, the integration is working.

Troubleshooting

Section titled “Troubleshooting”

400 Bad Request

Section titled “400 Bad Request”

OpenClaw reached UURoute, but UURoute rejected the request. This usually means one of the following values needs to be checked:

  • Base URL
  • API key
  • Model ID

404 Not Found

Section titled “404 Not Found”

The request path is incorrect. Check that the Base URL is exactly:

https://portal-api.stag.uuroute.net/v1

If OpenClaw appends its own path to the provider URL, a missing or extra path segment can cause a 404 error.