Saltar al contenido principal
Fireworks expone modelos de pesos abiertos y enrutados mediante una API compatible con OpenAI. Instala el Plugin oficial de proveedor Fireworks para usar dos modelos Kimi precatalogados y cualquier modelo o id de enrutador de Fireworks en tiempo de ejecución.
PropiedadValor
Id de proveedorfireworks (alias: fireworks-ai)
Paquete@openclaw/fireworks-provider
Variable env de authFIREWORKS_API_KEY
Flag de incorporación--auth-choice fireworks-api-key
Flag directa de CLI--fireworks-api-key <key>
APICompatible con OpenAI (openai-completions)
URL basehttps://api.fireworks.ai/inference/v1
Modelo predeterminadofireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias predeterminadoKimi K2.5 Turbo

​
Primeros pasos

1

Instala el Plugin

openclaw plugins install @openclaw/fireworks-provider
2

Configura la clave de API de Fireworks

openclaw onboard --auth-choice fireworks-api-key

openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"

export FIREWORKS_API_KEY=fw-...
La incorporación guarda la clave para el proveedor fireworks en tus perfiles de autenticación y establece el enrutador Fire Pass Kimi K2.5 Turbo como modelo predeterminado.
3

Verifica que el modelo esté disponible

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 resuelve, openclaw models status --json informa la credencial faltante en auth.unusableProfiles.

​
Configuración no interactiva

Para instalaciones con scripts o CI, pasa todo en la línea de comandos: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

​
Catálogo integrado

Ref. de modeloNombreEntradaContextoSalida máx.Razonamiento
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6texto + imagen262,144262,144Forzado a desactivado
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)texto + imagen256,000256,000Forzado a desactivado (predeterminado)
OpenClaw fija todos los modelos Kimi de Fireworks en thinking: off porque Kimi en Fireworks puede filtrar la cadena de pensamiento en la respuesta visible a menos que la solicitud desactive explícitamente el razonamiento. Enrutar el mismo modelo directamente mediante Moonshot conserva la salida de razonamiento de Kimi. Consulta los modos de razonamiento para cambiar entre proveedores.

​
Ids de modelos personalizados de Fireworks

OpenClaw acepta cualquier modelo o id de enrutador de Fireworks en tiempo de ejecución. Usa el id exacto que muestra Fireworks y antepón fireworks/. La resolución dinámica clona la plantilla Fire Pass (entrada de texto + imagen, API compatible con OpenAI, costo predeterminado cero) y desactiva el razonamiento automáticamente 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. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Cada ref. de modelo de Fireworks en OpenClaw empieza con fireworks/, seguido del id exacto o la ruta de enrutador 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 endpoint de Fireworks como el campo model compatible con OpenAI.
Fireworks sirve Kimi sin un canal de razonamiento separado, por lo que la cadena de pensamiento puede aparecer en el flujo visible de content. En cada solicitud Kimi de Fireworks, OpenClaw envía thinking: { type: "disabled" } y elimina reasoning, reasoning_effort y reasoningEffort del payload (extensions/fireworks/stream.ts). La política del proveedor (extensions/fireworks/thinking-policy.ts) anuncia solo el nivel de razonamiento off para ids de modelos Kimi, de modo que los cambios manuales de /think y las superficies de política del proveedor permanezcan 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.
Si el Gateway se ejecuta como un servicio administrado (launchd, systemd, Docker), la clave de Fireworks debe ser visible para ese proceso, no solo para tu shell interactiva.
Una clave exportada solo en una shell interactiva no ayudará a un daemon launchd o systemd a menos que ese entorno también se importe allí. Configura la clave en ~/.openclaw/.env o mediante env.shellEnv para que el proceso del gateway pueda leerla.
OpenClaw carga ~/.openclaw/.env cuando carga la configuración, por lo que las claves guardadas allí llegan a los servicios de gateway administrados en todas las plataformas. Reinicia el gateway (o vuelve a ejecutar openclaw doctor --fix) después de rotar la clave.

​
Relacionado

Proveedores de modelos

Elegir proveedores, refs. de modelos y comportamiento de conmutación por error.

Modos de razonamiento

Niveles de /think, políticas de proveedor 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.