Skip to main content
O Fireworks disponibiliza modelos de pesos abertos e roteados por meio de uma API compatível com a OpenAI. Instale o Plugin oficial do provedor Fireworks para usar dois modelos Kimi pré-catalogados e qualquer modelo ou identificador de roteador do Fireworks em tempo de execução.

Primeiros passos

1

Instale o Plugin

2

Defina a chave da API do Fireworks

A integração inicial 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.
3

Verifique se o modelo está disponível

A lista deve incluir Kimi K2.6 e Kimi K2.5 Turbo (Fire Pass). Se FIREWORKS_API_KEY não puder ser resolvida, openclaw models status --json informará a credencial ausente em auth.unusableProfiles.

Configuração não interativa

Para instalações automatizadas ou de CI, forneça tudo na linha de comando:

Catálogo integrado

O OpenClaw fixa todos os modelos Kimi do Fireworks em thinking: off, pois o Kimi no Fireworks pode expor a cadeia de raciocínio na resposta visível, a menos que a solicitação desative explicitamente o raciocínio. Rotear o mesmo modelo diretamente pelo Moonshot preserva a saída de raciocínio do Kimi. Consulte os modos de raciocínio para alternar entre provedores.

Identificadores personalizados de modelos do Fireworks

O OpenClaw aceita qualquer identificador de modelo ou roteador do Fireworks em tempo de execução. Use o identificador exato exibido pelo Fireworks e adicione o prefixo fireworks/. A resolução dinâmica clona o modelo de referência do Fire Pass (entrada de texto + imagem, API compatível com a OpenAI, custo padrão zero) e desativa automaticamente o raciocínio quando o identificador corresponde ao padrão do Kimi. Identificadores dinâmicos do GLM são marcados como exclusivos para texto, a menos que você configure uma entrada de modelo personalizada com entrada de imagem.
Toda referência de modelo do Fireworks no OpenClaw começa com fireworks/, seguido pelo identificador ou caminho de roteador exato 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 da API e envia o caminho restante ao endpoint do Fireworks como o campo model compatível com a OpenAI.
O Fireworks disponibiliza o Kimi sem um canal de raciocínio separado, portanto a cadeia de raciocínio pode aparecer no fluxo visível de content. Em cada solicitação do Kimi ao Fireworks, o OpenClaw envia thinking: { type: "disabled" } e remove reasoning, reasoning_effort e reasoningEffort da carga útil (extensions/fireworks/stream.ts). A política do provedor (extensions/fireworks/thinking-policy.ts) anuncia apenas o nível de raciocínio off para identificadores de modelos Kimi, mantendo as alterações manuais de /think e as superfícies de política do provedor 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.
Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), a chave do Fireworks deverá estar visível para esse processo — não apenas para o seu shell interativo.
Uma chave exportada somente em um shell interativo não ajudará um daemon do launchd ou systemd, a menos que esse ambiente também seja importado nele. Defina a chave em ~/.openclaw/.env ou por meio de env.shellEnv para torná-la legível pelo processo do Gateway.
O OpenClaw carrega ~/.openclaw/.env ao carregar a configuração, portanto as chaves armazenadas nesse arquivo chegam aos serviços gerenciados do Gateway em todas as plataformas. Reinicie o Gateway (ou execute openclaw doctor --fix novamente) após trocar a chave.

Relacionados

Provedores de modelos

Como escolher provedores, referências de modelos e o comportamento de failover.

Modos de raciocínio

Níveis de /think, políticas de provedores e roteamento de modelos com capacidade de raciocínio.

Moonshot

Execute o Kimi com a saída de raciocínio nativa pela própria API do Moonshot.

Solução de problemas

Solução de problemas gerais e perguntas frequentes.