Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks expone modelos de pesos abiertos y enrutados mediante una API compatible con OpenAI. OpenClaw incluye un Plugin de proveedor Fireworks incluido que se distribuye con dos modelos Kimi precatalogados y acepta cualquier ID de modelo o router de Fireworks en tiempo de ejecución.
PropiedadValor
ID del proveedorfireworks (alias: fireworks-ai)
Pluginincluido, enabledByDefault: true
Variable env de authFIREWORKS_API_KEY
Marca de onboarding--auth-choice fireworks-api-key
Marca CLI directa--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

Configura la clave de API de Fireworks

openclaw onboard --auth-choice fireworks-api-key
El onboarding almacena la clave para el proveedor fireworks en tus perfiles de auth y establece el router Kimi K2.5 Turbo de Fire Pass como modelo predeterminado.
2

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 puede resolver, 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.Thinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6texto + imagen262,144262,144Desactivado forzosamente
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)texto + imagen256,000256,000Desactivado forzosamente (predeterminado)
OpenClaw fija todos los modelos Kimi de Fireworks en thinking: off porque Fireworks rechaza los parámetros de thinking de Kimi en producción. Enrutar el mismo modelo directamente mediante Moonshot conserva la salida de razonamiento de Kimi. Consulta modos de thinking para cambiar entre proveedores.

​
IDs de modelo Fireworks personalizados

OpenClaw acepta cualquier ID de modelo o router de Fireworks en tiempo de ejecución. Usa el ID exacto que muestra Fireworks y anteponle fireworks/. La resolución dinámica clona la plantilla de Fire Pass (entrada de texto + imagen, API compatible con OpenAI, costo predeterminado cero) y desactiva el thinking automáticamente cuando el ID coincide con el patrón de Kimi. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Cada ref. de modelo Fireworks en OpenClaw empieza con fireworks/ seguido del ID o la ruta de router exactos de la plataforma Fireworks. Por ejemplo:
  • Modelo de router: 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 K2.6 devuelve un 400 si la solicitud lleva parámetros reasoning_*, aunque Kimi admite thinking mediante la propia API de Moonshot. La política incluida (extensions/fireworks/thinking-policy.ts) anuncia solo el nivel de thinking off para los IDs de modelo Kimi, de modo que los cambios manuales con /think y las superficies de política de 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 mediante é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 que solo esté en ~/.profile no ayudará a un daemon de 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.
En macOS, openclaw gateway install ya conecta ~/.openclaw/.env al archivo de entorno del LaunchAgent. Vuelve a ejecutar la instalación (o openclaw doctor --fix) después de rotar la clave.

​
Relacionado

Proveedores de modelos

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

Modos de thinking

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

Moonshot

Ejecuta Kimi con salida de thinking nativa mediante la propia API de Moonshot.

Solución de problemas

Solución de problemas general y preguntas frecuentes.