Providers
Fogos de artifício
Fireworks expõe modelos open-weight e roteados por meio de uma API compatível com OpenAI. O OpenClaw inclui um Plugin de provedor Fireworks integrado que vem com dois modelos Kimi pré-catalogados e aceita qualquer modelo ou id de roteador do Fireworks em tempo de execução.
| Propriedade | Valor |
|---|---|
| Id do provedor | fireworks (alias: fireworks-ai) |
| Plugin | integrado, enabledByDefault: true |
| Variável env de autenticação | FIREWORKS_API_KEY |
| Flag de integração | --auth-choice fireworks-api-key |
| Flag direta da CLI | --fireworks-api-key <key> |
| API | compatível com OpenAI (openai-completions) |
| URL base | https://api.fireworks.ai/inference/v1 |
| Modelo padrão | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| Alias padrão | Kimi K2.5 Turbo |
Primeiros passos
Defina a chave de API do 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-...
A integração armazena a chave para o provedor fireworks nos seus perfis de autenticação e define o roteador Kimi K2.5 Turbo Fire Pass como o modelo padrão.
Verifique se o modelo está disponível
openclaw models list --provider fireworks
A lista deve incluir Kimi K2.6 e Kimi K2.5 Turbo (Fire Pass). Se FIREWORKS_API_KEY não for resolvida, openclaw models status --json informará a credencial ausente em auth.unusableProfiles.
Configuração não interativa
Para instalações com script ou em CI, passe tudo pela linha de comando:
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 do modelo | Nome | Entrada | Contexto | Saída máx. | Pensamento |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | texto + imagem | 262,144 | 262,144 | Forçado como desativado |
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
Kimi K2.5 Turbo (Fire Pass) | texto + imagem | 256,000 | 256,000 | Forçado como desativado (padrão) |
Ids de modelos Fireworks personalizados
O OpenClaw aceita qualquer modelo ou id de roteador do Fireworks em tempo de execução. Use o id exato exibido pelo Fireworks e prefixe-o com fireworks/. A resolução dinâmica clona o modelo do Fire Pass (entrada de texto + imagem, API compatível com OpenAI, custo padrão zero) e desativa o pensamento automaticamente quando o id corresponde ao padrão do Kimi.
{
agents: {
defaults: {
model: {
primary: "fireworks/accounts/fireworks/models/<your-model-id>",
},
},
},
}
Como funciona a prefixação de id de modelo
Toda ref de modelo Fireworks no OpenClaw começa com fireworks/, seguida pelo id exato ou caminho de roteador da plataforma Fireworks. Por exemplo:
- Modelo de roteador:
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo - Modelo direto:
fireworks/accounts/fireworks/models/<model-name>
O OpenClaw remove o prefixo fireworks/ ao construir a solicitação de API e envia o caminho restante para o endpoint do Fireworks como o campo model compatível com OpenAI.
Por que o pensamento é forçado como desativado para o Kimi
O Fireworks K2.6 retorna 400 se a solicitação carregar parâmetros reasoning_*, embora o Kimi ofereça suporte a pensamento pela API própria do Moonshot. A política integrada (extensions/fireworks/thinking-policy.ts) anuncia apenas o nível de pensamento off para ids de modelo Kimi, para que alternâncias manuais de /think e superfícies de política de provedor permaneçam alinhadas ao contrato de tempo de execução.
Para usar o raciocínio do Kimi de ponta a ponta, configure o provedor Moonshot e roteie o mesmo modelo por ele.
Disponibilidade do ambiente para o daemon
Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), a chave do Fireworks precisa estar visível para esse processo, não apenas para seu shell interativo.
No macOS, openclaw gateway install já conecta ~/.openclaw/.env ao arquivo de ambiente do LaunchAgent. Execute a instalação novamente (ou openclaw doctor --fix) depois de rotacionar a chave.
Relacionado
Escolha de provedores, refs de modelo e comportamento de failover.
Níveis de /think, políticas de provedor e roteamento de modelos com capacidade de raciocínio.
Execute o Kimi com saída de pensamento nativa pela API própria do Moonshot.
Solução de problemas geral e FAQ.