Configurar Goose: API Key, Base URL y modelos

Conecte Goose a BetterToken con su proveedor OpenAI. En pruebas en macOS con un modelo GPT, Goose 1.55.0 completó solicitudes de texto y llamadas a herramientas de lectura de archivos mediante /v1/responses.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key en OPENAI_API_KEY
Base URL	https://bettertoken.ai en OPENAI_HOST, sin /v1
Modelo	YOUR_MODEL_ID en GOOSE_MODEL
Proveedor	GOOSE_PROVIDER=openai

Requisitos previos

• Un terminal macOS o Linux para ejecutar estos comandos
• Una BetterToken API Key: regístrate y obtén una
• Un Model ID copiado de la model plaza

Instalación

Usa el instalador oficial de Goose:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
goose --version

Configuración manual

Sustituye YOUR_API_KEY y YOUR_MODEL_ID antes de ejecutar:

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 debe contener la raíz del sitio. No incluyas /v1 en este campo, aunque el proveedor sea OpenAI.

Para acceder a archivos, ejecuta goose configure, elige Toggle Extensions y activa developer. La extensión developer proporciona herramientas para archivos y shell.

Verificar la conexión

Ejecuta este comando en el mismo terminal:

goose run --no-session --max-turns 4 -t "Reply with only: OK"

Comprueba que la respuesta final sea OK. Para probar el acceso a archivos por separado, ejecuta Goose en tu proyecto y pídele que lea un archivo conocido; comprueba tanto el resultado de la herramienta como la respuesta final.

Cambiar de modelo

Asigna a GOOSE_MODEL otro Model ID exacto de la model plaza y comienza una nueva ejecución.

Errores frecuentes

Síntoma	Qué comprobar
Falla la autenticación	Comprueba OPENAI_API_KEY en el terminal donde se ejecuta Goose.
URL de solicitud incorrecta	Asigna https://bettertoken.ai a OPENAI_HOST, sin /v1 ni un sufijo de endpoint.
Herramientas de archivos no disponibles	Activa la extensión integrada developer con goose configure.
Las solicitudes siguen usando Responses	En las pruebas con Goose 1.55.0, ni siquiera OPENAI_BASE_PATH=v1/chat/completions cambió la ruta del modelo probado, que siguió siendo /v1/responses. Comprueba la ruta real de la solicitud.

Enlaces relacionados

• Comparar herramientas compatibles
• Errores de API y límites de solicitudes
• Variables de entorno de Goose

Detalles técnicos

Las solicitudes de texto y lectura de archivos probadas usaron /v1/responses. Los nombres del proveedor y de las variables de entorno no bastan para determinar qué protocolo elige Goose con otro modelo.