OpenClaw
OpenClaw puede usar un provider OpenAI-compatible con una Key dedicada y URL base /v1. Conserva gateway y modelo en la configuración de OpenClaw, define un presupuesto y una lista de modelos permitidos, reinicia el servicio y verifica un mensaje privado antes de exponer un canal.
Antes de empezar
Instala la versión actual del cliente sólo desde su editor oficial. Antes de cambiar una configuración local, crea una API Key dedicada en la consola; no reutilices una Key personal, compartida o de despliegue de producción.
Windows, macOS y Linux
- Windows: usa el instalador actual de Windows o el flujo de PowerShell y cierra todos los procesos del cliente después de cambiar un archivo de configuración.
- macOS: usa la aplicación firmada o el instalador oficial de terminal para tu CPU; los ajustes del directorio personal pertenecen a ese usuario de macOS.
- Linux / WSL: sigue las instrucciones actuales de la distribución o del CLI oficial; WSL lee su directorio personal de Linux, no el perfil de Windows.
Elegir un modelo
Llama a GET /v1/models con la Key dedicada y selecciona un data[].id devuelto. La lista limitada por Key es la fuente de verdad; una configuración anterior, un artículo o un selector del cliente no garantiza acceso.
Configuración
{
"models": {
"providers": {
"aishop": {
"baseUrl": "https://ai.tavonilo.com/v1",
"apiKey": "sk-your-own-key"
}
}
},
"agents": {
"defaults": { "model": { "primary": "aishop/your-console-model" } }
}
}Verificación
Comprueba la Key con /v1/models, realiza una solicitud pequeña sin datos sensibles y conserva sólo hora, ruta, modelo, estado HTTP e ID de solicitud para soporte. Un timeout no demuestra que una generación facturable no se procesó, por lo que no repitas ciegamente solicitudes largas o de imagen.
Recuperación segura
- 401: sustituye una Key incompleta, revocada o equivocada; no la pegues en una solicitud a soporte.
- 403: comprueba el grupo de la Key, visibilidad del modelo, saldo y permiso de ruta.
- 404: usa la Base URL mostrada aquí, no un endpoint completo, y no añadas /v1 dos veces.
- 429: encola el trabajo y respeta Retry-After si existe; no repitas un lote en paralelo.
- 5xx o timeout: reintenta de forma limitada sólo si la operación es segura. Conserva hora, ruta, modelo, estado HTTP e ID de solicitud en registros anonimizados.
Límite de credenciales
Usa una Key por dispositivo o carga de trabajo. Nunca envíes a soporte una API Key, auth.json, prompt privado completo, contraseña, código de verificación o datos de pago; revoca y reemplaza una Key de inmediato si sospechas exposición.