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

Providers

Fuegos artificiales

Fireworks ofrece modelos de pesos abiertos y enrutados mediante una API compatible con OpenAI. Instala el Plugin oficial del proveedor Fireworks para usar dos modelos Kimi precatalogados y cualquier modelo o id de enrutador de Fireworks en tiempo de 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-k2p5-turbo
Alias predeterminado Kimi K2.5 Turbo

Primeros pasos

  • Instalar el Plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Configurar 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 variable de entorno
    export FIREWORKS_API_KEY=fw-...

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

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider fireworks

    La lista debería incluir Kimi K2.6 y Kimi K2.5 Turbo (Fire Pass). Si FIREWORKS_API_KEY no se puede resolver, openclaw models status --json informa de la credencial ausente en auth.unusableProfiles.

    • Configuración no interactiva

    Para instalaciones mediante scripts o CI, pasa 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 de forma forzada
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) texto + imagen 256,000 256,000 Desactivado de forma forzada (predeterminado)

    Ids de modelos personalizados de Fireworks

    OpenClaw acepta cualquier id de modelo o enrutador de Fireworks en tiempo de ejecución. Usa el id exacto que muestra Fireworks y añádele el prefijo fireworks/. La resolución dinámica clona la plantilla de Fire Pass (entrada de texto + imagen, API compatible con OpenAI y 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, a menos que configures 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 prefijo de los ids de modelo

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

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

    OpenClaw elimina el prefijo fireworks/ al construir la solicitud de API y envía la ruta restante al punto de conexión de Fireworks como el campo model compatible con OpenAI.

    Por qué el razonamiento se desactiva de forma forzada para Kimi

    Fireworks sirve Kimi sin un canal de razonamiento independiente, por lo que la cadena de razonamiento puede aparecer en el flujo visible de 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 permanecen alineados con el contrato de tiempo de ejecución.

    Para usar el razonamiento de Kimi de extremo a extremo, configura el proveedor Moonshot y enruta el mismo modelo a través de él.

    Disponibilidad del entorno para el daemon

    Si el Gateway se ejecuta como servicio administrado (launchd, systemd, Docker), la clave de Fireworks debe ser visible para ese proceso, no solo para tu 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. Reinicia el Gateway (o vuelve a ejecutar openclaw doctor --fix) después de rotar la clave.

    Contenido relacionado

    Proveedores de modelos

    Elecció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

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

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

    On this page