Użyj OpenClaw z CometAPI

Używaj CometAPI jako dostawcy modeli dla OpenClaw — ponad 500 modeli w jednym API.

Wymagania wstępne

Node.js ≥ 22 — zalecana instalacja przez nvm
Konto CometAPI z aktywnym kluczem API — odbierz je tutaj

Instalacja

Pobierz swój klucz API CometAPI

Zaloguj się do konsoli CometAPI. Kliknij Add API Key i skopiuj swój klucz API CometAPI.

Panel CometAPI z przyciskiem Add API Key

Szczegóły klucza API CometAPI z base URL

Zainstaluj lub zaktualizuj OpenClaw

Zalecane — użyj oficjalnego instalatora:

curl -fsSL https://openclaw.ai/install.sh | bash

Lub zainstaluj przez npm:

npm install -g openclaw@latest

Następnie uruchom kreator konfiguracji jeden raz:

openclaw onboard --install-daemon

Podczas onboardingu wybierz Skip w kroku Model/Auth, jeśli chcesz skonfigurować CometAPI ręcznie. Po zakończeniu onboardingu potwierdź, że gateway działa:

openclaw gateway status
openclaw dashboard

Konfiguracja

Zapisz swój klucz CometAPI

Zapisz swój klucz w ~/.openclaw/.env, aby był dostępny dla demona bez twardego kodowania go w plikach konfiguracyjnych:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

Jeśli już wstrzykujesz COMETAPI_KEY przez swoją powłokę, menedżera usług lub workflow zarządzania sekretami, pomiń ten krok — poniższa konfiguracja używa $\{COMETAPI_KEY\} niezależnie od tego, w jaki sposób zmienna jest ustawiona.

Skonfiguruj dostawców CometAPI

CometAPI obsługuje cztery formaty API. Dodaj jeden lub więcej bloków provider do ~/.openclaw/openclaw.json:

Provider	Format API	Wywoływany endpoint	Base URL
`cometapi-openai`	`openai-completions`	`POST /v1/chat/completions`	`https://api.cometapi.com/v1`
`cometapi-openai-responses`	`openai-responses`	`POST /v1/responses`	`https://api.cometapi.com/v1`
`cometapi-claude`	`anthropic-messages`	`POST /messages`	`https://api.cometapi.com`
`cometapi-google`	`google-generative-ai`	`POST /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" }]
      }
    }
  }
}

Możesz zachować tylko tych providerów, których potrzebujesz, albo zachować wszystkie cztery, aby kierować żądania między formatami za pomocą odwołań provider/model.Zastąp każdy placeholder your-...-model-id aktualnym model ID ze strony CometAPI Models page, który pasuje do danego bloku provider.

Użyj cometapi-openai-responses (api: "openai-responses") dla modeli, które wymagają OpenAI Responses API. Użyj cometapi-openai (api: "openai-completions") dla modeli na klasycznej ścieżce Chat Completions. Oba współdzielą ten sam baseUrl (https://api.cometapi.com/v1); jedyna różnica polega na tym, który endpoint downstream wywołuje OpenClaw.

Plik auth-profiles.json nie jest wymagany dla tej konfiguracji. Klucze providerów są rozwiązywane z models.providers.*.apiKey przez zmienną środowiskową $\{COMETAPI_KEY\}. auth-profiles.json jest potrzebny tylko wtedy, gdy chcesz rotacji poświadczeń per profil dla wielu kluczy.

Weryfikacja

Uruchom ponownie i zweryfikuj

Uruchom ponownie gateway po dodaniu .env lub zmianie konfiguracji provider:

openclaw gateway restart

Następnie uruchom diagnostykę:

openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor

Prawidłowo zakończona konfiguracja wygląda następująco:

openclaw models status rozwiązuje model podstawowy do cometapi-claude/your-claude-model-id bez ostrzeżeń o brakującym uwierzytelnianiu dla providerów CometAPI
openclaw models list --provider cometapi-claude wyświetla skonfigurowane modele
openclaw doctor nie zgłasza błędów konfiguracji ani uwierzytelniania dla providerów CometAPI

OpenClaw models status pokazujący providerów CometAPI jako uwierzytelnionych

Przełączanie modeli

Przełącz modele

# 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

Rozwiązywanie problemów

Czysta reinstalacja (opcjonalnie)

Jeśli naprawiasz uszkodzoną starszą konfigurację, zatrzymaj gateway, usuń ~/.openclaw, a następnie ponownie uruchom onboarding przed zastosowaniem konfiguracji CometAPI:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

To usuwa całą lokalną konfigurację, sesje, logi, stan autoryzacji i obszary robocze. Następnie ponownie wykonaj kroki 3–5.

Przegląd

Agenci AI do programowania

Agenci AI

Klienci czatu AI

Tłumaczenie i język

Platformy automatyzacji

Obserwowalność i ewaluacja

Frameworki AI

Wymagania wstępne

Instalacja

Konfiguracja

Weryfikacja

Przełączanie modeli

Rozwiązywanie problemów

​Wymagania wstępne

​Instalacja

​Konfiguracja

​Weryfikacja

​Przełączanie modeli

​Rozwiązywanie problemów

Wymagania wstępne

Instalacja

Konfiguracja

Weryfikacja

Przełączanie modeli

Rozwiązywanie problemów