OpenHands CLI einrichten: API Key, Base URL und Modelle

Verbinde OpenHands CLI über Umgebungsvariablen mit BetterToken. In einem macOS-Test mit einem GPT-Modell verarbeitete OpenHands CLI 1.16.0 Textanfragen im Headless-Modus und Datei-Leseaufrufe über /v1/responses.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key für LLM_API_KEY
Base URL	https://bettertoken.ai/v1 für LLM_BASE_URL
Modell	openai/YOUR_MODEL_ID für LLM_MODEL
Konfigurationsüberschreibung	--override-with-envs

Voraussetzungen

• uv und Python 3.12 oder neuer
• Ein BetterToken API Key: Registrieren und Key erhalten
• Eine Model ID aus der model plaza

Installation

Verwende den Paketnamen und den Befehl aus der offiziellen Installationsanleitung:

uv tool install openhands --python 3.12
openhands --version

Manuelle Einrichtung

Ersetze YOUR_API_KEY und YOUR_MODEL_ID. Behalte das Präfix openai/ in LLM_MODEL bei:

export LLM_MODEL="openai/YOUR_MODEL_ID"
export LLM_API_KEY="YOUR_API_KEY"
export LLM_BASE_URL="https://bettertoken.ai/v1"

Übergib --override-with-envs beim Start von OpenHands, damit diese Variablen gespeicherte Einstellungen überschreiben. Die Überschreibung gilt nur für diesen Lauf und speichert die Werte nicht in der Konfiguration.

Verbindung prüfen

openhands --headless --json --override-with-envs -t "Reply with only: OK"

Prüfe in der JSONL-Ausgabe, ob die finale Antwort OK enthält. Teste den Dateizugriff separat, indem du OpenHands aus deinem Projekt startest und eine bekannte Datei lesen lässt. Prüfe sowohl das Tool-Ergebnis als auch die finale Antwort.

Modell wechseln

Setze LLM_MODEL auf openai/ gefolgt von einer anderen exakten Model ID. Starte den Befehl erneut mit --override-with-envs.

Häufige Fehler

Symptom	Prüfung
Umgebungsvariablen werden nicht angewendet	Füge --override-with-envs zum Befehl hinzu.
Authentifizierung schlägt fehl	Prüfe LLM_API_KEY im Terminal, in dem OpenHands ausgeführt wird.
Falscher Endpunkt	Verwende https://bettertoken.ai/v1 als LLM_BASE_URL, ohne /responses oder /chat/completions.
Modell nicht gefunden	Behalte das Präfix openai/ bei und kopiere den Rest von LLM_MODEL exakt aus der model plaza.

Weiterführende Links

• Unterstützte Tools vergleichen
• API-Fehler und Ratenlimits
• OpenHands CLI-Befehlsreferenz

Technische Details

OpenHands CLI 1.16.0 sendete die getesteten Text- und Datei-Leseanfragen an /v1/responses. Belasse die Base URL bei /v1; der Client ergänzt den Anfragepfad.