Pular para o conteúdo principal
Fireworks expõe modelos open-weight e roteados por meio de uma API compatível com OpenAI. Instale o Plugin oficial de provedor Fireworks para usar dois modelos Kimi pré-catalogados e qualquer modelo ou id de roteador Fireworks em tempo de execução.
PropriedadeValor
ID do provedorfireworks (alias: fireworks-ai)
Pacote@openclaw/fireworks-provider
Var. de ambiente authFIREWORKS_API_KEY
Flag de onboarding--auth-choice fireworks-api-key
Flag direta da CLI--fireworks-api-key <key>
APICompatível com OpenAI (openai-completions)
URL basehttps://api.fireworks.ai/inference/v1
Modelo padrãofireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias padrãoKimi K2.5 Turbo

​
Primeiros passos

1

Instale o plugin

openclaw plugins install @openclaw/fireworks-provider
2

Configure a chave de API da 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-...
O onboarding armazena a chave no provedor fireworks nos seus perfis de autenticação e define o roteador Fire Pass Kimi K2.5 Turbo como o modelo padrão.
3

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 relata a credencial ausente em auth.unusableProfiles.

​
Configuração não interativa

Para instalações com scripts ou 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 modeloNomeEntradaContextoSaída máx.Raciocínio
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6texto + imagem262.144262.144Forçado como desligado
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)texto + imagem256.000256.000Forçado como desligado (padrão)
O OpenClaw fixa todos os modelos Kimi da Fireworks em thinking: off porque a Fireworks rejeita parâmetros de raciocínio do Kimi em produção. Rotear o mesmo modelo diretamente pelo Moonshot preserva a saída de raciocínio do Kimi. Consulte modos de raciocínio para alternar entre provedores.

​
IDs de modelo Fireworks personalizados

O OpenClaw aceita qualquer modelo ou id de roteador Fireworks em tempo de execução. Use o id exato mostrado pela Fireworks e prefixe-o com fireworks/. A resolução dinâmica clona o template Fire Pass (entrada de texto + imagem, API compatível com OpenAI, custo padrão zero) e desativa o raciocínio automaticamente quando o id corresponde ao padrão Kimi. IDs dinâmicos GLM são marcados como somente texto, a menos que você configure uma entrada de modelo personalizada com entrada de imagem. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
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 Fireworks como o campo model compatível com OpenAI.
Fireworks K2.6 retorna um 400 se a solicitação carrega parâmetros reasoning_*, embora o Kimi ofereça suporte a raciocínio pela própria API da Moonshot. A política de provedor (extensions/fireworks/thinking-policy.ts) anuncia apenas o nível de raciocínio off para ids de modelo Kimi, para que alternâncias manuais de /think e superfícies de política do provedor fiquem alinhadas ao contrato de runtime.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 da Fireworks precisa estar visível para esse processo — não apenas para seu shell interativo.
Uma chave exportada apenas em um shell interativo não ajudará um daemon 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.
No macOS, openclaw gateway install já conecta ~/.openclaw/.env ao arquivo de ambiente do LaunchAgent. Execute a instalação novamente (ou openclaw doctor --fix) após rotacionar a chave.

​
Relacionados

Provedores de modelo

Escolha de provedores, refs. de modelo e comportamento de failover.

Modos de raciocínio

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

Moonshot

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

Solução de problemas

Solução de problemas geral e perguntas frequentes.