Pular para o conteúdo 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 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.
PropriedadeValor
Id do provedorfireworks (alias: fireworks-ai)
Pluginintegrado, enabledByDefault: true
Variável env de autenticaçãoFIREWORKS_API_KEY
Flag de integração--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

Defina a chave de API do Fireworks

openclaw onboard --auth-choice fireworks-api-key
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.
2

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

​
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>",
      },
    },
  },
}
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.
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.
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.
Uma chave presente apenas em ~/.profile não ajudará um daemon launchd ou systemd, a menos que esse ambiente também seja importado ali. Defina a chave em ~/.openclaw/.env ou via 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) depois de rotacionar a chave.

​
Relacionado

Provedores de modelos

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

Modos de pensamento

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 pensamento nativa pela API própria do Moonshot.

Solução de problemas

Solução de problemas geral e FAQ.