OpenHands

Create your API key →

Mint an aireserve_api_… key in the portal — every OpenHands agent step is then metered and billed through your organization.

OpenHands routes all model traffic through LiteLLM, so the gateway plugs in with the standard three variables (OpenHands custom-endpoint docs). The openai/ prefix on the model id means “OpenAI-compatible endpoint” — it routes Claude models too:

export LLM_MODEL="openai/gpt-5.4-mini"              # or openai/claude-sonnet-4-6
export LLM_BASE_URL="https://api.aireserve.com/v1"  # /v1 suffix
export LLM_API_KEY="$AIRESERVE_API_KEY"             # your aireserve_api_… key

Install the CLI and run a task headlessly (uv tool install openhands, or pipx install openhands):

openhands --headless --override-with-envs -t "write a hello-world script"

--override-with-envs is required. Without it the CLI ignores the LLM_* variables in favor of ~/.openhands/ settings — and on a fresh install it waits for the interactive first-run wizard instead. Interactive sessions (openhands with no flags) can also set the same three values in the settings UI: Custom Model, Base URL, API Key.

The Docker GUI takes the same three variables as -e LLM_MODEL=…, -e LLM_BASE_URL=…, -e LLM_API_KEY=… on docker run.

Verify

Run the headless one-liner above from an empty directory. The agent completes the task and exits, and each LLM step appears on your usage page — one request per agent turn, all metered against your key.

⌘I

Getting started

Connect your tool

Models

Capabilities

Migrate

Data & privacy

Create your API key →

Verify

Create your API key →

​Verify

Verify