Seedream 5.0 Pro è LIVE | Prova nel Generatore di immagini →
Accedi
DashboardEsploraGeneratore AIHotApp DesktopChiavi APIRicarica
Setup agent

Connetti OpenClaw alla WaveSpeed LLM API

Copia il setup ~/.openclaw/openclaw.json consigliato per OpenClaw, instrada le richieste a /v1/chat/completions e verifica le chiamate agent locali in WaveSpeed Logs.

API keyTesta modello
File di configurazione

~/.openclaw/openclaw.json

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Avvio rapido

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.openclaw/openclaw.json

4

Esegui openclaw gateway e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Modifica ~/.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,
          },
        ],
      },
    },
  },
}

Non sostituire il nome della variabile

WAVESPEED_API_KEY è il nome della variabile d’ambiente letta dall’agent. Mantieni questo nome nel file di configurazione e inserisci la vera API key nella shell.

1

Temporaneo per questo terminale

Funziona finché non chiudi questa finestra del terminale.

export WAVESPEED_API_KEY="wsk_live_..."
2

Mantieni dopo il riavvio

Scrive la key nel profilo shell così i nuovi terminali possono leggerla.

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

Guida integrazione agent

Usa OpenClaw con la WaveSpeed LLM API

Questa guida mostra come collegare OpenClaw a WaveSpeed AI con ~/.openclaw/openclaw.json, Chat completions compatibili con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modello predefinito deepseek/deepseek-v4-flash. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.openclaw/openclaw.json
4

Esegui openclaw gateway e controlla Logs

Cosa configura questo setup di OpenClaw

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Modello

deepseek/deepseek-v4-flash

La configurazione pronta da copiare sopra è l’unico file OpenClaw da modificare per il setup consigliato: ~/.openclaw/openclaw.json. Mantieni la API key nell’ambiente shell per non committarla in un repository.

Risoluzione problemi

La API key non viene letta

Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui OpenClaw. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.

Le richieste falliscono con errore di protocollo o endpoint

Controlla che OpenClaw usi Chat completions compatibili con OpenAI ed endpoint /v1/chat/completions. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.

Il modello selezionato non funziona

Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.openclaw/openclaw.json. Puoi iniziare dal modello predefinito mostrato in questa pagina.

In Logs non appare alcuna richiesta

Assicurati che OpenClaw usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.

Questa guida OpenClaw può apparire nei motori di ricerca?

Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano OpenClaw custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.

Vedi tutte le guide di setup agentSfoglia modelli
Usa OpenClaw con la WaveSpeed LLM API