Goose einrichten: API Key, Base URL und Modelle
Goose mit BetterToken API Key, OpenAI-Host und Model ID konfigurieren. Aktiviere die developer-Erweiterung und teste eine Textanfrage.
Verbinde Goose über den OpenAI-Provider mit BetterToken. In einem macOS-Test mit einem GPT-Modell verarbeitete Goose 1.55.0 Textanfragen und Datei-Leseaufrufe über /v1/responses.
Wichtige Einstellungen
| Feld | Wert |
|---|---|
| API Key | BetterToken API Key für OPENAI_API_KEY |
| Base URL | https://bettertoken.ai für OPENAI_HOST, ohne /v1 |
| Modell | YOUR_MODEL_ID für GOOSE_MODEL |
| Anbieter | GOOSE_PROVIDER=openai |
Voraussetzungen
- Ein macOS- oder Linux-Terminal für die folgenden Befehle
- Ein BetterToken API Key: registrieren und Key erhalten
- Eine Model ID aus der model plaza
Installation
Verwende den offiziellen Goose-Installer:
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bashgoose --versionManuelle Einrichtung
Ersetze vor dem Ausführen YOUR_API_KEY und YOUR_MODEL_ID:
export GOOSE_PROVIDER="openai"export GOOSE_MODEL="YOUR_MODEL_ID"export OPENAI_API_KEY="YOUR_API_KEY"export OPENAI_HOST="https://bettertoken.ai"OPENAI_HOST erwartet die Website-Root-URL. Lass /v1 aus diesem Feld weg, auch wenn der Provider OpenAI ist.
Für den Dateizugriff führe goose configure aus, wähle Toggle Extensions und aktiviere developer. Die developer-Erweiterung stellt Datei- und Shell-Tools bereit.
Verbindung prüfen
Führe diesen Befehl im selben Terminal aus:
goose run --no-session --max-turns 4 -t "Reply with only: OK"Prüfe, ob die finale Antwort OK lautet. Teste den Dateizugriff separat, indem du Goose in deinem Projekt startest und eine bekannte Datei lesen lässt. Prüfe sowohl das Tool-Ergebnis als auch die finale Antwort.
Modell wechseln
Setze GOOSE_MODEL auf eine andere exakte Model ID aus der model plaza und starte einen neuen Lauf.
Häufige Fehler
| Symptom | Prüfung |
|---|---|
| Authentifizierung schlägt fehl | Prüfe OPENAI_API_KEY im Terminal, in dem Goose ausgeführt wird. |
| Falsche Anfrage-URL | Setze OPENAI_HOST auf https://bettertoken.ai, ohne /v1 oder einen Endpunkt-Suffix. |
| Datei-Tools sind nicht verfügbar | Aktiviere die integrierte Erweiterung developer mit goose configure. |
| Anfragen verwenden weiterhin Responses | Im Test mit Goose 1.55.0 änderte selbst OPENAI_BASE_PATH=v1/chat/completions die Route des getesteten Modells nicht; sie blieb /v1/responses. Prüfe den tatsächlichen Anfragepfad. |
Weiterführende Links
Technische Details
Die getesteten Text- und Datei-Leseanfragen verwendeten /v1/responses. Aus Provider- und Umgebungsvariablennamen allein lässt sich nicht ableiten, welches Protokoll Goose für ein anderes Modell auswählt.

