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

Providers

Fireworks

Fireworks ofrece modelos de pesos abiertos y enrutados mediante una API compatible con OpenAI. Instale el Plugin oficial del proveedor Fireworks para usar dos modelos Kimi precatalogados y cualquier modelo o id de enrutador de Fireworks durante la ejecución.

Propiedad Valor
Id del proveedor fireworks (alias: fireworks-ai)
Paquete @openclaw/fireworks-provider
Variable de entorno de autenticación FIREWORKS_API_KEY
Opción de incorporación --auth-choice fireworks-api-key
Opción directa de la CLI --fireworks-api-key <key>
API Compatible con OpenAI (openai-completions)
URL base https://api.fireworks.ai/inference/v1
Modelo predeterminado fireworks/accounts/fireworks/routers/kimi-k2p6-turbo
Alias predeterminado Kimi K2.6 Turbo

Primeros pasos

  • Instalar el Plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Establecer la clave de API de Fireworks

    Incorporación
    openclaw onboard --auth-choice fireworks-api-key
    Opción directa
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Solo entorno
    export FIREWORKS_API_KEY=fw-...

    La incorporación almacena la clave para el proveedor fireworks en los perfiles de autenticación y establece el enrutador Kimi K2.6 Turbo Fire Pass como modelo predeterminado.

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider fireworks

    La lista debe incluir Kimi K2.6 y Kimi K2.6 Turbo (Fire Pass). Si FIREWORKS_API_KEY no se resuelve, openclaw models status --json informa de la credencial que falta en auth.unusableProfiles.

    • Configuración no interactiva

    Para instalaciones mediante scripts o en un Pipeline de CI, proporcione todo en la línea de comandos:

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice fireworks-api-key \  --fireworks-api-key "$FIREWORKS_API_KEY" \  --skip-health \  --accept-risk

    Catálogo integrado

    Referencia del modelo Nombre Entrada Contexto Salida máxima Razonamiento
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 texto + imagen 262,144 262,144 Desactivado obligatoriamente
    fireworks/accounts/fireworks/routers/kimi-k2p6-turbo Kimi K2.6 Turbo (Fire Pass) texto + imagen 256,000 256,000 Desactivado obligatoriamente (predeterminado)

    Ids de modelos personalizados de Fireworks

    OpenClaw acepta cualquier id de modelo o enrutador de Fireworks durante la ejecución. Use el id exacto que muestra Fireworks y añada el prefijo fireworks/. La resolución dinámica clona la plantilla de Fire Pass (entrada de texto + imagen, API compatible con OpenAI, coste predeterminado cero) y desactiva automáticamente el razonamiento cuando el id coincide con el patrón de Kimi. Los ids dinámicos de GLM se marcan como solo texto, salvo que se configure una entrada de modelo personalizada con entrada de imagen.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Cómo funciona el uso de prefijos en los ids de modelo

    Cada referencia de modelo de Fireworks en OpenClaw comienza con fireworks/, seguido del id exacto o la ruta del enrutador de la plataforma Fireworks. Por ejemplo:

    • Modelo de enrutador: fireworks/accounts/fireworks/routers/kimi-k2p6-turbo
    • Modelo directo: fireworks/accounts/fireworks/models/<model-name>

    OpenClaw elimina el prefijo fireworks/ al crear la solicitud de API y envía la ruta restante al endpoint de Fireworks como el campo model compatible con OpenAI.

    Por qué el razonamiento se desactiva obligatoriamente para Kimi

    Fireworks sirve Kimi sin un canal de razonamiento independiente, por lo que la cadena de pensamiento puede aparecer en el flujo visible content. En cada solicitud de Kimi a Fireworks, OpenClaw envía thinking: { type: "disabled" } y elimina reasoning, reasoning_effort y reasoningEffort de la carga útil (extensions/fireworks/stream.ts). La política del proveedor (extensions/fireworks/thinking-policy.ts) anuncia únicamente el nivel de razonamiento off para los ids de modelos Kimi, de modo que los cambios manuales de /think y las superficies de políticas del proveedor se mantengan alineados con el contrato de ejecución.

    Para usar el razonamiento de Kimi de extremo a extremo, configure el proveedor Moonshot y enrute el mismo modelo mediante él.

    Disponibilidad del entorno para el demonio

    Si el Gateway se ejecuta como servicio administrado (launchd, systemd, Docker), la clave de Fireworks debe estar disponible para ese proceso, no solo para el shell interactivo.

    OpenClaw carga ~/.openclaw/.env al cargar la configuración, por lo que las claves almacenadas allí llegan a los servicios administrados del Gateway en todas las plataformas. Reinicie el Gateway (o vuelva a ejecutar openclaw doctor --fix) después de rotar la clave.

    Contenido relacionado

    Proveedores de modelos

    Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.
    Modos de razonamiento

    Niveles de /think, políticas de proveedores y enrutamiento de modelos con capacidad de razonamiento.
    Moonshot

    Ejecute Kimi con salida de razonamiento nativa mediante la API propia de Moonshot.
    Solución de problemas

    Solución general de problemas y preguntas frecuentes.
    Was this useful?
    On this page

    On this page