OpenClaw

Połącz OpenClaw z CometAPI: zainstaluj przez curl lub npm, zapisz swój klucz w ~/.openclaw/.env, skonfiguruj dostawców OpenAI/Anthropic/Google i uruchamiaj ponad 500 modeli.

Używaj CometAPI jako dostawcy modeli dla OpenClaw — ponad 500 modeli w jednym API. Ten przewodnik obejmuje aktualny proces wdrożenia (2026.3.8+).

​

Wymagania wstępne

• Node.js ≥ 22 — zalecane przez nvm
• Konto CometAPI z aktywnym kluczem API — pobierz je tutaj

1. Pobierz swój klucz API CometAPI

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

   

   
2. 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 kreatora 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
   
3. Zapisz swój klucz CometAPI

   Zapisz swój klucz w ~/.openclaw/.env, aby był dostępny dla daemon bez wpisywania go na stałe w plikach konfiguracyjnych:

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   Jeśli już wstrzykujesz COMETAPI_KEY przez shell, menedżera usług lub workflow do zarządzania sekretami, pomiń ten krok — poniższa konfiguracja używa $\{COMETAPI_KEY\} niezależnie od sposobu ustawienia tej zmiennej.

4. Skonfiguruj providery 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 zostawić tylko providerów, których potrzebujesz, albo zachować wszystkie cztery, aby przełączać się między formatami za pomocą odwołań provider/model.

   Zastąp każdy placeholder your-...-model-id aktualnym ID modelu ze strony CometAPI Models page, który pasuje do danego bloku provider.

   Użyj cometapi-openai-responses (api: "openai-responses") dla modeli wymagających OpenAI Responses API. Użyj cometapi-openai (api: "openai-completions") dla modeli korzystających z klasycznej ścieżki Chat Completions. Oba używają tego samego 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 w tej konfiguracji. Klucze provider są rozwiązywane z models.providers.*.apiKey przez zmienną środowiskową $\{COMETAPI_KEY\}. auth-profiles.json jest potrzebny tylko wtedy, gdy chcesz rotować dane uwierzytelniające per profil między wieloma kluczami.

5. 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
   

   Poprawnie 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 uwierzytelnieniu dla providerów CometAPI
   • openclaw models list --provider cometapi-claude wyświetla skonfigurowane modele
   • openclaw doctor nie zgłasza błędów konfiguracji ani uwierzytelnienia dla providerów CometAPI

   
6. 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
   

Czysta reinstalacja (opcjonalnie)

Jeśli naprawiasz starszą, uszkodzoną 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 uwierzytelnienia i workspace’y. Następnie wykonaj ponownie kroki 3–5.