Hopp til hovedinnhold
Bruk CometAPI som modelleverandør for OpenClaw — 500+ modeller i ett API. Denne veiledningen dekker den gjeldende onboarding-flyten (2026.3.8+).

Forutsetninger

  • Node.js ≥ 22 — anbefalt via nvm
  • En CometAPI-konto med en aktiv API-nøkkel — skaff din her
1

Hent CometAPI API-nøkkelen din

Logg inn i CometAPI-konsollen. Klikk på Add API Key og kopier sk-xxxxx-nøkkelen din.
CometAPI-dashbord som viser knappen Add API Key
Detaljer for CometAPI API-nøkkel med base-URL
2

Installer eller oppdater OpenClaw

Anbefalt — bruk det offisielle installasjonsprogrammet:
curl -fsSL https://openclaw.ai/install.sh | bash
Eller installer via npm:
npm install -g openclaw@latest
Kjør deretter oppsettsveiviseren én gang:
openclaw onboard --install-daemon
Under onboardingen velger du Skip i trinnet Model/Auth hvis du vil konfigurere CometAPI manuelt. Etter onboardingen bekrefter du at gatewayen kjører:
openclaw gateway status
openclaw dashboard
3

Lagre CometAPI-nøkkelen din

Skriv nøkkelen din til ~/.openclaw/.env slik at den er tilgjengelig for daemonen uten å hardkodes i konfigurasjonsfiler:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Hvis du allerede injiserer COMETAPI_KEY via skallet ditt, tjenesteadministratoren eller en secrets-arbeidsflyt, hopper du over dette trinnet — konfigurasjonen nedenfor bruker $\{COMETAPI_KEY\} uansett hvordan variabelen settes.
4

Konfigurer CometAPI-providers

CometAPI støtter fire API-formater. Legg til én eller flere provider-blokker i ~/.openclaw/openclaw.json:
ProviderAPI FormatEndpoint calledBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /v1beta/...https://api.cometapi.com/v1beta
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}
Du kan beholde bare providerne du trenger, eller beholde alle fire for å rute mellom formater ved hjelp av provider/model-referanser.Erstatt hver your-...-model-id-plassholder med en gjeldende modell-ID fra CometAPI Models-siden som samsvarer med provider-blokken.
Bruk cometapi-openai-responses (api: "openai-responses") for modeller som krever OpenAI Responses API. Bruk cometapi-openai (api: "openai-completions") for modeller på den klassiske Chat Completions-stien. Begge deler samme baseUrl (https://api.cometapi.com/v1); den eneste forskjellen er hvilket downstream-endpoint OpenClaw kaller.
Filen auth-profiles.json er ikke påkrevd for dette oppsettet. Provider-nøkler løses fra models.providers.*.apiKey via env-variabelen $\{COMETAPI_KEY\}. auth-profiles.json er bare nødvendig hvis du ønsker per-profil-rotasjon av legitimasjon på tvers av flere nøkler.
5

Start på nytt og verifiser

Start gatewayen på nytt etter at du har lagt til .env eller endret provider-konfigurasjonen:
openclaw gateway restart
Kjør deretter diagnostikk:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Et vellykket oppsett ser slik ut:
  • openclaw models status løser den primære modellen til cometapi-claude/your-claude-model-id uten missing-auth-advarsler for CometAPI-providers
  • openclaw models list --provider cometapi-claude viser de konfigurerte modellene dine
  • openclaw doctor rapporterer ingen konfigurasjons- eller auth-feil for CometAPI-providers
OpenClaw models status som viser CometAPI-providers autentisert
6

Bytt modeller

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id
Hvis du prøver å rette opp et eldre oppsett som ikke fungerer, stopper du gatewayen, fjerner ~/.openclaw, og kjører deretter onboarding på nytt før du bruker CometAPI-konfigurasjonen:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Dette fjerner all lokal konfigurasjon, økter, logger, auth-tilstand og arbeidsområder. Følg deretter trinn 3–5 på nytt.