Seedream 5.0 Pro está no ar | Experimente no Gerador de Imagens →
Setup do agente

Conecte OpenClaw à API LLM da WaveSpeed

Copie o setup ~/.openclaw/openclaw.json recomendado para OpenClaw, roteie requests para /v1/chat/completions e verifique chamadas locais do agente em WaveSpeed Logs.

Arquivo de configuração

~/.openclaw/openclaw.json

Protocolo

Chat completions compatíveis com OpenAI

Endpoint

/v1/chat/completions

Início rápido

1

Crie uma chave de acesso WaveSpeed

2

Exporte localmente a chave necessária

3

Cole a configuração em~/.openclaw/openclaw.json

4

Execute openclaw gateway e confira Logs

Chat completions compatíveis com OpenAI

O uso aparece em Dashboard e Logs

Troque modelos sem reescrever o código do agente

Editar ~/.openclaw/openclaw.json
// File: ~/.openclaw/openclaw.json  (JSON5)
{
  agents: {
    defaults: {
      model: { primary: "wavespeed/deepseek/deepseek-v4-flash" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      wavespeed: {
        baseUrl: "https://llm.wavespeed.ai/v1",
        apiKey: "${WAVESPEED_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "deepseek/deepseek-v4-flash",
            name: "deepseek/deepseek-v4-flash",
            contextWindow: 200000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

Não substitua o nome da variável

WAVESPEED_API_KEY é o nome da variável de ambiente que o agente lê. Mantenha esse nome no arquivo de configuração e coloque sua API key real no shell.

1

Temporário neste terminal

Funciona até você fechar esta janela do terminal.

export WAVESPEED_API_KEY="wsk_live_..."
2

Manter após reiniciar

Grava a key no perfil do shell para que novos terminais possam lê-la.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Guia de integração de agente

Use OpenClaw com a API LLM da WaveSpeed

Este guia mostra como conectar OpenClaw à WaveSpeed AI com ~/.openclaw/openclaw.json, Chat completions compatíveis com OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modelo padrão deepseek/deepseek-v4-flash. Copie a configuração acima, exporte sua API key, execute o agente e verifique os requests em Logs.

1

Crie uma chave de acesso WaveSpeed

2

Exporte localmente a chave necessária

3

Cole a configuração em

~/.openclaw/openclaw.json
4

Execute openclaw gateway e confira Logs

O que este setup de OpenClaw configura

Protocolo

Chat completions compatíveis com OpenAI

Endpoint

/v1/chat/completions

Modelo

deepseek/deepseek-v4-flash

A configuração pronta para copiar acima é o único arquivo OpenClaw que você precisa editar no setup recomendado: ~/.openclaw/openclaw.json. Mantenha a API key no ambiente shell para não enviá-la a um repositório.

Solução de problemas

A API key não está sendo lida

Exporte WAVESPEED_API_KEY na mesma shell em que você executa OpenClaw. Se usar um perfil de shell, recarregue o terminal antes de iniciar o agente.

Requests falham com erro de protocolo ou endpoint

Confira se OpenClaw está usando Chat completions compatíveis com OpenAI e endpoint /v1/chat/completions. Incompatibilidades de protocolo são a causa mais comum de erros 404 ou payload.

O modelo selecionado não funciona

Confirme que o ID do modelo existe em WaveSpeed Models e cole o ID exato em ~/.openclaw/openclaw.json. Você pode começar com o modelo padrão mostrado nesta página.

Nenhum request aparece em Logs

Garanta que OpenClaw use a base URL da WaveSpeed e sua API key atual. Depois envie um novo prompt pelo agente local e atualize Logs.

Este guia de OpenClaw pode aparecer em buscas?

Sim. Esta página foi criada como um guia de setup indexável para usuários que pesquisam OpenClaw custom provider, endpoint compatível com OpenAI, base URL e fluxos de configuração local de agentes.

Use OpenClaw com a API LLM da WaveSpeed