Fireworks

Fireworks expone modelos de pesos abiertos y enrutados a través de una API compatible con OpenAI. OpenClaw incluye un complemento de proveedor de Fireworks integrado que se envía con dos modelos Kimi pre-catalogados y acepta cualquier modelo o enrutador de Fireworks en tiempo de ejecución.

Propiedad	Valor
ID del proveedor	`fireworks` (alias: `fireworks-ai`)
Complemento	incluido, `enabledByDefault: true`
Variable de entorno de autenticación	`FIREWORKS_API_KEY`
Indicador de incorporación	`--auth-choice fireworks-api-key`
Indicador directo de 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`

Para empezar

Establecer la clave de API de Fireworks
Ventana de terminal
openclaw onboard --auth-choice fireworks-api-key
Ventana de terminal
openclaw onboard --non-interactive \ --auth-choice fireworks-api-key \ --fireworks-api-key "$FIREWORKS_API_KEY"
Ventana de terminal
export FIREWORKS_API_KEY=fw-...
La incorporación guarda la clave para el proveedor fireworks en sus perfiles de autenticación y establece el enrutador Fire Pass Kimi K2.5 Turbo como el modelo predeterminado.
Verificar que el modelo esté disponible
Ventana de terminal
```
openclaw models list --provider fireworks
```
La lista debe incluir Kimi K2.6 y Kimi K2.5 Turbo (Fire Pass). Si FIREWORKS_API_KEY no está resuelto, openclaw models status --json informa la credencial faltante en auth.unusableProfiles.

Configuración no interactiva

Para instalaciones con scripts o CI, pase 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

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

Identificadores de modelos personalizados de Fireworks

OpenClaw acepta cualquier identificador de modelo o enrutador de Fireworks en tiempo de ejecución. Use el identificador exacto mostrado por Fireworks y prefíjelo con 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 pensamiento automáticamente cuando el identificador coincide con el patrón Kimi.

{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/

”, }, }, }, }

Cómo funciona el prefijado de identificadores de modelo

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

Modelo de enrutador: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Modelo directo: `fireworks/accounts/fireworks/models/

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.

Por qué se fuerza el desactivado del pensamiento para Kimi

Fireworks K2.6 devuelve un 400 si la solicitud lleva parámetros reasoning_* aunque Kimi admite el pensamiento a través de la API propia de Moonshot. La política incluida (extensions/fireworks/thinking-policy.ts) anuncia solo el nivel de pensamiento off para los IDs de modelo Kimi, por lo que los interruptores manuales /think y las superficies de la política del proveedor se mantienen alineados con el contrato de tiempo de ejecución.

Para utilizar el razonamiento de Kimi de extremo a extremo, configure el proveedor Moonshot y enrute el mismo modelo a través de él.

Disponibilidad del entorno para el demonio

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 su shell interactivo.

En macOS, openclaw gateway install ya conecta ~/.openclaw/.env al archivo de entorno del LaunchAgent. Vuelva a ejecutar la instalación (o openclaw doctor --fix) después de rotar la clave.

Relacionado

Proveedores de modelos

Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.

Thinking modes

/think niveles, políticas del proveedor y enrutamiento de modelos con capacidad de razonamiento.

Moonshot

Ejecute Kimi con salida de pensamiento nativa a través de la propia API de Moonshot.

Solución de problemas

Solución de problemas generales y preguntas frecuentes.