OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

LiteLLM

LiteLLM es un gateway de LLM de código abierto con una API unificada para más de 100 proveedores de modelos. Enrute OpenClaw a través de LiteLLM para centralizar el seguimiento de costos, el registro, las claves virtuales con límites de gasto y la conmutación por error entre backends sin cambiar la configuración de OpenClaw.

Inicio rápido

Incorporación (recomendado)

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

Para realizar una configuración no interactiva con un proxy remoto, pase explícitamente la URL del proxy:

bash
openclaw onboard --non-interactive --accept-risk --auth-choice litellm-api-key \  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

Configuración manual

  • Iniciar el proxy de LiteLLM

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

  • Conectar OpenClaw a LiteLLM

    bash
    export LITELLM_API_KEY="your-litellm-key"openclaw

    • Configuración

    json5
    {  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" },    },  },}

    El modelo predeterminado que escribe el proceso de incorporación es litellm/claude-opus-4-6.

    Generación de imágenes

    LiteLLM puede servir de backend para la herramienta image_generate mediante las rutas compatibles con OpenAI /images/generations y /images/edits. El modelo de imágenes predeterminado es gpt-image-2; configure otro en agents.defaults.imageGenerationModel:

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",      },    },  },  agents: {    defaults: {      imageGenerationModel: {        primary: "litellm/gpt-image-2",        timeoutMs: 180_000,      },    },  },}

    Las URL de LiteLLM en local loopback (http://localhost:4000, 127.0.0.1, ::1, host.docker.internal) funcionan sin una anulación global de la red privada. Para un proxy alojado en la LAN, establezca models.providers.litellm.request.allowPrivateNetwork: true, ya que la clave de API se envía a ese host.

    Opciones avanzadas

    Claves virtuales

    Cree una clave específica para OpenClaw con límites de gasto:

    bash
    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"  }'

    Use la clave generada como LITELLM_API_KEY.

    Enrutamiento de modelos

    LiteLLM puede enrutar las solicitudes de modelos a distintos backends. Configúrelo en el archivo config.yaml de LiteLLM:

    yaml
    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 sigue solicitando claude-opus-4-6; LiteLLM se encarga del enrutamiento.

    Consultar el uso
    bash
    # Información de la clavecurl "http://localhost:4000/key/info" \  -H "Authorization: Bearer sk-litellm-key" # Registros de gastocurl "http://localhost:4000/spend/logs" \  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
    Notas sobre el comportamiento del proxy
    • LiteLLM se ejecuta de forma predeterminada en http://localhost:4000.
    • OpenClaw se conecta a través del endpoint /v1 compatible con OpenAI y de tipo proxy de LiteLLM.
    • La adaptación de solicitudes exclusiva de OpenAI nativo no se aplica a través de una URL base de LiteLLM configurada: sin service_tier, sin store de Responses, sin indicaciones para la caché de prompts y sin adaptación de la carga útil del esfuerzo de razonamiento de OpenAI.
    • Los encabezados ocultos de atribución de OpenClaw (originator, version, User-Agent) solo se envían a endpoints nativos de OpenAI verificados, por lo que no se insertan al usar una URL base personalizada de LiteLLM.

    Contenido relacionado

    Documentación de LiteLLM

    Documentación oficial de LiteLLM y referencia de la API.
    Selección de modelos

    Descripción general de todos los proveedores, las referencias de modelos y el comportamiento de conmutación por error.
    Configuración

    Referencia completa de configuración.
    Modelos

    Cómo elegir y configurar modelos.
    Was this useful?
    On this page

    On this page