Configurar OpenHands CLI: API Key, Base URL y modelos

Conecta OpenHands CLI a BetterToken mediante variables de entorno. En pruebas en macOS con un modelo GPT, OpenHands CLI 1.16.0 completó solicitudes de texto sin interfaz y llamadas a herramientas de lectura de archivos mediante /v1/responses.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key en LLM_API_KEY
Base URL	https://bettertoken.ai/v1 en LLM_BASE_URL
Modelo	openai/YOUR_MODEL_ID en LLM_MODEL
Anulación de configuración	--override-with-envs

Requisitos previos

• uv y Python 3.12 o posterior
• Una BetterToken API Key: Regístrate y obtén una
• Un Model ID copiado de la model plaza

Instalación

Usa el nombre del paquete y el comando de la guía de instalación oficial:

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

Configuración manual

Sustituye YOUR_API_KEY y YOUR_MODEL_ID. Mantén el prefijo openai/ en LLM_MODEL:

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

Incluye --override-with-envs al iniciar OpenHands para que estas variables sustituyan los ajustes guardados. El cambio solo se aplica a esa ejecución y no guarda los valores en la configuración.

Verificar la conexión

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

Comprueba que la respuesta final de la salida JSONL contenga OK. Para probar el acceso a archivos por separado, inicia OpenHands desde 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 LLM_MODEL openai/ seguido de otro Model ID exacto. Vuelve a ejecutar el comando con --override-with-envs.

Errores frecuentes

Síntoma	Qué comprobar
No se aplican los ajustes del entorno	Incluye --override-with-envs en el comando.
Falla la autenticación	Comprueba LLM_API_KEY en el terminal donde se ejecuta OpenHands.
Endpoint incorrecto	Usa https://bettertoken.ai/v1 como LLM_BASE_URL, sin /responses ni /chat/completions.
No se encuentra el modelo	Mantén el prefijo openai/ y copia el resto de LLM_MODEL tal como aparece en la model plaza.

Enlaces relacionados

• Comparar herramientas compatibles
• Errores de API y límites de solicitudes
• Referencia de comandos de OpenHands CLI

Detalles técnicos

OpenHands CLI 1.16.0 envió las solicitudes de texto y lectura de archivos probadas a /v1/responses. Mantén la Base URL en /v1; el cliente añade la ruta de la solicitud.