OpenClaw gebruiken met CometAPI

Gebruik deze handleiding om OpenClaw te verbinden met CometAPI. Kies één API-indeling en model-ID voor de eerste configuratie.

OpenClaw v2026.8.1 wordt ook aangeduid als OpenClaw 2.0. Het pakket gebruikt geen 2.x versienummer. Zie de aankondiging van OpenClaw 2.0 en de releasenotes van v2026.8.1.

Officiële OpenClaw-referenties:

Vereisten

Node.js 22.22.3+, 24.15+ of 25.9+. Node 26 wordt aanbevolen. Node 23 wordt niet ondersteund.
Een CometAPI-account met een actieve API-sleutel van het dashboard.
Een model-ID van de CometAPI Models-pagina.

Installatie en upgrades

Eerste installatie
Een installatie upgraden

Het officiële installatieprogramma kan de CLI installeren zonder onboarding te starten. Hierdoor blijft de modelconfiguratie een afzonderlijke stap.

macOS / Linux / WSL2
Windows PowerShell

Met de volgende opdracht wordt het officiële installatieprogramma uitgevoerd:

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

Met de volgende opdracht wordt het officiële PowerShell-installatieprogramma uitgevoerd:

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Als je Node.js en npm zelf beheert, accepteren npm 11.16+ en npm 12 de --allow-scripts optie. Met de volgende opdracht installeer je OpenClaw zonder onboarding te starten:

npm install -g openclaw@latest --allow-scripts=openclaw

Bij npm 11.15 en eerder moet je --allow-scripts=openclaw weglaten, omdat die npm- versie de optie niet herkent.Controleer of de geïnstalleerde CLI voldoet aan de minimale versie voor deze handleiding:

openclaw --version

Ga verder naar CometAPI configureren. Voer niet eerst gewone onboarding uit, omdat de begeleide stroom niet elke aangepaste API- adapter beschikbaar maakt.

Maak en controleer een back-up voordat je een belangrijke update uitvoert. Het archief kan API-sleutels, kanaalstatus en authenticatiegegevens bevatten, dus beveilig het zoals je de OpenClaw-statusmap beveiligt.Met de volgende opdrachten maak je de back-up en werk je OpenClaw bij:

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

Herstel na de update ondersteunde migraties en controleer de Gateway-status:

openclaw doctor --fix
openclaw gateway restart
openclaw health

Een update behoudt de geconfigureerde modelroute. Herhaal onboarding niet tenzij je de modelprovider of de authenticatie daarvan wilt wijzigen.

CometAPI configureren

Klassieke onboarding gebruiken

Klassieke onboarding is de aanbevolen route voor een eerste installatie voor Chat Completions, Responses en Anthropic Messages. Met de volgende opdracht wordt de klassieke onboarding geopend en de achtergrond service geïnstalleerd:

openclaw onboard --classic --install-daemon

Kies in Model/Auth, kies Custom Provider. Voer vervolgens de waarden in voor een van deze compatibiliteitsopties:

API-indeling	Provider-ID	Compatibiliteitsoptie	Base URL
Chat Completions	`cometapi-openai`	Compatibel met OpenAI	`https://api.cometapi.com/v1`
Responses	`cometapi-openai-responses`	Compatibel met OpenAI Responses	`https://api.cometapi.com/v1`
Anthropic Messages	`cometapi-claude`	Compatibel met Anthropic	`https://api.cometapi.com`

Voer de overeenkomende provider-ID, your-model-id, en uw CometAPI API-sleutel in wanneer daarom wordt gevraagd. De terminalwizard maskeert de invoer van de API-sleutel. Het klassieke menu Custom Provider bevat niet de Google Generative AI adapter. Voltooi om die adapter te gebruiken Een provider configureren met config-opdrachten, stel het primaire model in en voer vervolgens de klassieke onboarding uit. Kies Bestaande modelconfiguratie behouden wanneer de wizard die optie toont.

Een provider configureren met config-opdrachten

Gebruik dit pad voor de Google-adapter of voor gecontroleerde configuratiewijzigingen. OpenClaw ondersteunt JSON5, dus parse en herschrijf openclaw.json niet met een strikte JSON-tool.

De ingebouwde configuratieschrijver van OpenClaw valideert JSON5, maar normaliseert het bestand naar JSON wanneer het schrijft. Bestaande opmerkingen, volgkomma’s en opmaak kunnen worden verwijderd. Maak een geverifieerde back-up voordat u een patch toepast als deze details belangrijk voor u zijn.

Druk eerst het pad van de actieve configuratie af en valideer de inhoud ervan:

openclaw config file
openclaw config validate

OpenClaw leest API-sleutels van providers uit de procesomgeving of het globale statusbestand .env. Het vertrouwt een workspacebestand .env niet voor API-sleutels van providers. Het globale bestand is ~/.openclaw/.env, of $OPENCLAW_STATE_DIR/.env wanneer OPENCLAW_STATE_DIR is ingesteld. Sla de volgende stap over als de klassieke onboarding de API-sleutel heeft opgeslagen. Anders gebruikt u het tabblad voor uw besturingssysteem om de API-sleutel op te slaan zonder deze weer te geven .

macOS / Linux / WSL2
Windows PowerShell

Met de volgende opdrachten wordt COMETAPI_KEY atomair bijgewerkt en een lege waarde geweigerd:

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

Met de volgende opdrachten wordt COMETAPI_KEY bijgewerkt zonder deze weer te geven:

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

Inspecteer het doelpad voordat u een provider toevoegt. Vervang de provider-ID in de volgende opdracht door de ID van het door u geselecteerde tabblad:

openclaw config get models.providers.cometapi-openai --json

Als de opdracht een geconfigureerde provider retourneert, stopt u voordat u het voorbeeld toepast. config patch voegt objecten samen, maar vervangt arrays. Voeg het nieuwe model samen in de modelarray van de provider voordat u die array schrijft. Hiermee blijven model metadata, aangepaste headers en andere providerinstellingen behouden. Kies één API-indeling. Elke patch gebruikt een SecretRef met een omgevingsvariabele als basis, wijzigt alleen de doelconfiguratiepaden en houdt andere configuratiesecties intact.

Een model-ID is niet automatisch compatibel met elke API-adapter. Selecteer een adapter die het exacte CometAPI-model en de route ondersteunen, en verifieer vervolgens die combinatie van provider/model/adapter met een live aanvraag. De your-model-id onderstaande waarde is een configuratieplaceholder, geen universele compatibiliteitsclaim.

Chat Completions
Responses
Anthropic Messages
Google Generative AI

Provider-ID: cometapi-openai
OpenClaw-adapter: openai-completions
Base URL: https://api.cometapi.com/v1
Referentie voor primair model: cometapi-openai/your-model-id

Maak cometapi.patch.json5 met deze providerpatch:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valideer de patch voordat OpenClaw de configuratie schrijft:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Pas dezelfde patch toe als de validatie slaagt:

openclaw config patch --file ./cometapi.patch.json5

Als er geen primair model is geconfigureerd, stelt u dit model in als standaard:

openclaw models set cometapi-openai/your-model-id

Verifieer de providerconfiguratie en verstuur een minimale modelaanvraag:

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

Voer deze chatopdracht uit om de actieve OpenClaw-chatsessie te wisselen:

/model cometapi-openai/your-model-id

Provider-ID: cometapi-openai-responses
OpenClaw-adapter: openai-responses
Base URL: https://api.cometapi.com/v1
Referentie voor primair model: cometapi-openai-responses/your-model-id

Maak cometapi.patch.json5 met deze providerpatch:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valideer de patch voordat OpenClaw de configuratie schrijft:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Pas dezelfde patch toe als de validatie slaagt:

openclaw config patch --file ./cometapi.patch.json5

Als er geen primair model is geconfigureerd, stelt u dit model in als standaard:

openclaw models set cometapi-openai-responses/your-model-id

Verifieer de providerconfiguratie en verstuur een minimale modelaanvraag:

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

Voer deze chatopdracht uit om de actieve OpenClaw-chatsessie te wisselen:

/model cometapi-openai-responses/your-model-id

Provider-ID: cometapi-claude
OpenClaw-adapter: anthropic-messages
Base URL: https://api.cometapi.com
Referentie voor primair model: cometapi-claude/your-model-id

Maak cometapi.patch.json5 met deze providerpatch:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valideer de patch voordat OpenClaw de configuratie schrijft:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Pas dezelfde patch toe als de validatie slaagt:

openclaw config patch --file ./cometapi.patch.json5

Als er geen primair model is geconfigureerd, stelt u dit model in als standaard:

openclaw models set cometapi-claude/your-model-id

Verifieer de providerconfiguratie en verstuur een minimale modelaanvraag:

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

Voer deze chatopdracht uit om de actieve OpenClaw-chatsessie te wisselen:

/model cometapi-claude/your-model-id

Provider-ID: cometapi-google
OpenClaw-adapter: google-generative-ai
Base URL: https://api.cometapi.com/v1beta
Referentie voor primair model: cometapi-google/your-model-id

Maak cometapi.patch.json5 met deze providerpatch:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valideer de patch voordat OpenClaw de configuratie schrijft:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Pas dezelfde patch toe als de validatie slaagt:

openclaw config patch --file ./cometapi.patch.json5

Als er geen primair model is geconfigureerd, stelt u dit model in als standaard:

openclaw models set cometapi-google/your-model-id

Verifieer de providerconfiguratie en verstuur een minimale modelaanvraag:

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

Voer deze chatopdracht uit om de actieve OpenClaw-chatsessie te wisselen:

/model cometapi-google/your-model-id

Als een configuratie al de provider-ID cometapi-gemini gebruikt, behoudt u die ID en gebruikt u deze in modelreferenties en opdrachten. Hernoem deze niet en maak geen dubbele provider aan alleen om deze handleiding te volgen.

OpenClaw 2026.8.1-modellijst met vier CometAPI-providerindelingen

Voor een nieuwe provider biedt openclaw config set hetzelfde schema en dezelfde SecretRef-controles. Gebruik --strict-json, --merge en --dry-run vóór het schrijven. Het volgende alternatief toont een voorbeeld van de Chat Completions-provider:

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

Als de dry run slaagt, herhaalt u de opdracht zonder --dry-run om deze op te slaan. Pas dit voorbeeld niet toe op een geconfigureerde provider. De array models moet de volledige samengevoegde modellijst van de provider bevatten voordat deze wordt geschreven.

Modelmetadata begrijpen

De minimale patches declareren een model voor alleen tekst. Voeg optionele metadata alleen toe wanneer u de specificaties van het model hebt geverifieerd:

Veld	Effect
`input`	Declareert geaccepteerde invoermodaliteiten. Gebruik `["text", "image"]` alleen wanneer het model native afbeeldingsinvoer accepteert.
`contextWindow`	Legt de native capaciteit van het Context Window van het model vast.
`contextTokens`	Beperkt het actieve invoerbudget zonder dit te wijzigen `contextWindow`.
`maxTokens`	Beperkt de output Tokens die OpenClaw van het model aanvraagt.

Onjuiste waarden kunnen ondersteunde invoer verbergen, de bruikbare context overschatten of een niet-ondersteunde uitvoergrootte aanvragen. Behoud your-model-id in herbruikbare voorbeelden, en gebruik de CometAPI Models-pagina om een model-ID te selecteren.

Controleer de volledige configuratie

Start de Gateway opnieuw op nadat u wijzigingen hebt aangebracht in het configuratiebestand of het globale bestand .env:

openclaw gateway restart

Valideer vervolgens de configuratie en de status van de Gateway:

openclaw config validate
openclaw doctor
openclaw health

Voer de providerspecifieke opdrachten uit vanaf het tabblad met de geselecteerde API-indeling. Een modellijst of statuscontrole bevestigt alleen de configuratie. De opdracht openclaw agent exec verstuurt een echte modelaanvraag. Controleer of deze OPENCLAW_OK retourneert zonder een onopgeloste authenticatie-, adapter- of modelfout. Als OpenClaw een aanvraag opnieuw probeert, registreer en inspecteer dan elke poging in plaats van de laatste markering als succes na één poging te beschouwen.

Probleemoplossing

De API-sleutel ontbreekt

Controleer of COMETAPI_KEY aanwezig is in de procesomgeving of in het bestand .env voor de globale status. Druk de waarde niet af in de terminaluitvoer.Nadat u de vertrouwde sleutelbron hebt gecorrigeerd, start u de Gateway opnieuw op en controleert u deze:

openclaw gateway restart
openclaw health

Een provider-ID heeft andere instellingen

Overschrijf geen provider met een andere baseUrl, api, aangepaste headers of modelmetadata. Inspecteer eerst de doelprovider:

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

Gebruik een andere provider-ID wanneer beide configuraties bewust zijn. Als het verschil per ongeluk is ontstaan, maakt u een geverifieerde back-up voordat u de doelprovider wijzigt.

Een update is niet voltooid

Inspecteer de updatestatus voordat u de installatie herstelt:

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

Met deze opdrachten blijft de statusmap behouden.

Een rollback van code is vereist

Installeer een bekende pakketversie opnieuw met behoud van de statusmap. Bekijk eerst een voorbeeld van de bewerking:

openclaw update --tag 2026.8.1 --dry-run

Als het voorbeeld correct is, voert u dezelfde bewerking uit zonder --dry-run:

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

Herstel alleen een statusback-up wanneer de geïnstalleerde code de status niet kan lezen. Een statusherstel kan sessies en configuratiewijzigingen verwijderen die na de back-up zijn gemaakt.

Overzicht

AI-codeeragents

AI-agents

AI-chatclients

Vertaling en taal

Automatiseringsplatforms

Observeerbaarheid en evaluatie

AI-frameworks

Vereisten

Installatie en upgrades

CometAPI configureren

Klassieke onboarding gebruiken

Een provider configureren met config-opdrachten

Modelmetadata begrijpen

Controleer de volledige configuratie

Probleemoplossing

​Vereisten

​Installatie en upgrades

​CometAPI configureren

​Klassieke onboarding gebruiken

​Een provider configureren met config-opdrachten

​Modelmetadata begrijpen

​Controleer de volledige configuratie

​Probleemoplossing

Vereisten

Installatie en upgrades

CometAPI configureren

Klassieke onboarding gebruiken

Een provider configureren met config-opdrachten

Modelmetadata begrijpen

Controleer de volledige configuratie

Probleemoplossing