Providers
Fuegos artificiales
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.
| Propiedad | Valor |
|---|---|
| ID del proveedor | fireworks (alias: fireworks-ai) |
| Plugin | incluido, enabledByDefault: true |
| Variable env de auth | FIREWORKS_API_KEY |
| Marca de onboarding | --auth-choice fireworks-api-key |
| Marca CLI directa | --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
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-...
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.
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 modelo | Nombre | Entrada | Contexto | Salida máx. | Thinking |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | texto + imagen | 262,144 | 262,144 | Desactivado forzosamente |
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
Kimi K2.5 Turbo (Fire Pass) | texto + imagen | 256,000 | 256,000 | Desactivado forzosamente (predeterminado) |
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>",
},
},
},
}
Cómo funciona el prefijo de ID de modelo
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.
Por qué el thinking se desactiva forzosamente para Kimi
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.
Disponibilidad del entorno para el daemon
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.
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
Elegir proveedores, refs. de modelo y comportamiento de conmutación por error.
Niveles de /think, políticas de proveedor y enrutamiento de modelos con capacidad de razonamiento.
Ejecuta Kimi con salida de thinking nativa mediante la propia API de Moonshot.
Solución de problemas general y preguntas frecuentes.