Configura LiteLLM con OpenClaw

¿Te ha pasado que pierdes el control de cuánto estás gastando al probar diferentes modelos de IA? Gestionar múltiples API keys y cambiar la configuración cada vez que quieres probar un proveedor nuevo es una pérdida de tiempo. Es frustrante no tener un lugar centralizado para ver logs o poner límites de presupuesto cuando trabajas en tus proyectos.

LiteLLM soluciona esto actuando como un Gateway que unifica más de 100 proveedores en una sola API. Te recomiendo usarlo con OpenClaw si quieres:

• Cost tracking: Mira exactamente cuánto gasta OpenClaw en todos los modelos.
• Model routing: Cambia entre Claude, GPT-4, Gemini o Bedrock sin tocar la configuración de OpenClaw.
• Virtual keys: Crea llaves con límites de gasto específicos.
• Logging: Logs completos de peticiones y respuestas para debugging.

Requisitos previos

• LiteLLM instalado.
• Una instancia de OpenClaw.
• API keys de tus proveedores de modelos.
• Acceso a la terminal.

Inicio rápido

Tienes dos formas de empezar. La más rápida es usando el comando de configuración asistida:

openclaw onboard --auth-choice litellm-api-key

Si prefieres la configuración manual, sigue estos pasos:

1. Inicia el LiteLLM Proxy:

pip install 'litellm[proxy]'
litellm --model claude-opus-4-6

2. Conecta OpenClaw a LiteLLM:

export LITELLM_API_KEY="your-litellm-key"

openclaw

Listo. OpenClaw ahora enviará todo el tráfico a través de LiteLLM.

Configuration

Environment variables

Para autenticarte, define tu llave en el entorno:

export LITELLM_API_KEY="sk-litellm-key"

Config file

Si usas un archivo de configuración, define los proveedores y modelos así:

{
  models: {
    providers: {
      litellm: {
        baseUrl: "http://localhost:4000",
        apiKey: "${LITELLM_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "claude-opus-4-6",
            name: "Claude Opus 4.6",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 200000,
            maxTokens: 64000,
          },
          {
            id: "gpt-4o",
            name: "GPT-4o",
            reasoning: false,
            input: ["text", "image"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "litellm/claude-opus-4-6" },
    },
  },
}

Virtual keys

Te recomiendo crear una llave dedicada para OpenClaw con límites de gasto. Esto evita sorpresas en tu factura:

curl -X POST "http://localhost:4000/key/generate" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key_alias": "openclaw",
    "max_budget": 50.00,
    "budget_duration": "monthly"
  }'

Usa la llave que obtengas como tu LITELLM_API_KEY.

Model routing

Puedes hacer que LiteLLM gestione qué backend usar sin que OpenClaw se entere. Configura tu config.yaml en LiteLLM:

model_list:
  - model_name: claude-opus-4-6
    litellm_params:
      model: claude-opus-4-6
      api_key: os.environ/ANTHROPIC_API_KEY

  - model_name: gpt-4o
    litellm_params:
      model: gpt-4o
      api_key: os.environ/OPENAI_API_KEY

OpenClaw seguirá pidiendo claude-opus-4-6, pero LiteLLM se encargará de dirigir la petición al proveedor correcto.

Viewing usage

Para revisar el consumo, puedes usar el dashboard de LiteLLM o la API:

# Información de la llave
curl "http://localhost:4000/key/info" \
  -H "Authorization: Bearer sk-litellm-key"

# Logs de gasto
curl "http://localhost:4000/spend/logs" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"

Solución de problemas

• Error de conexión: Por defecto, LiteLLM corre en http://localhost:4000. Asegúrate de que el puerto esté libre.
• Endpoint no encontrado: OpenClaw se conecta mediante el endpoint /v1/chat/completions compatible con OpenAI. Verifica que tu configuración en LiteLLM no esté bloqueando esta ruta.

AI Setup Assistant

Próximos pasos

• LiteLLM Docs
• Model Providers