Перейти до основного вмісту
Використовуйте CometAPI як провайдера моделей для OpenClaw — 500+ моделей в одному API. У цьому посібнику описано поточний процес початкового налаштування (2026.3.8+).

​
Передумови

1

Отримайте свій CometAPI API key

Увійдіть до консолі CometAPI. Натисніть Add API Key і скопіюйте свій ключ sk-xxxxx.
Панель CometAPI з кнопкою Add API Key
Деталі API key CometAPI з base URL
2

Встановіть або оновіть OpenClaw

Рекомендовано — використовуйте офіційний інсталятор:
curl -fsSL https://openclaw.ai/install.sh | bash
Або встановіть через npm:
npm install -g openclaw@latest
Потім один раз запустіть майстер налаштування:
openclaw onboard --install-daemon
Під час onboarding виберіть Skip на кроці Model/Auth, якщо хочете налаштувати CometAPI вручну. Після onboarding переконайтеся, що gateway запущено:
openclaw gateway status
openclaw dashboard
3

Збережіть свій ключ CometAPI

Запишіть свій ключ у ~/.openclaw/.env, щоб він був доступний daemon без жорсткого прописування у config файлах:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Якщо ви вже передаєте COMETAPI_KEY через shell, service manager або workflow для secrets, пропустіть цей крок — наведений нижче config використовує $\{COMETAPI_KEY\} незалежно від того, як саме задано змінну.
4

Налаштуйте провайдерів CometAPI

CometAPI підтримує чотири формати API. Додайте один або кілька блоків провайдерів до ~/.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" }]
      }
    }
  }
}
Ви можете залишити лише потрібних провайдерів або зберегти всі чотири, щоб маршрутизувати між форматами за допомогою посилань provider/model.Замініть кожен заповнювач your-...-model-id на актуальний ID моделі зі сторінки CometAPI Models, який відповідає блоку провайдера.
Використовуйте cometapi-openai-responses (api: "openai-responses") для моделей, яким потрібен OpenAI Responses API. Використовуйте cometapi-openai (api: "openai-completions") для моделей на класичному шляху Chat Completions. Обидва використовують однаковий baseUrl (https://api.cometapi.com/v1); різниця лише в тому, який downstream endpoint викликає OpenClaw.
Файл auth-profiles.json не є обов’язковим для цього налаштування. Ключі провайдерів беруться з models.providers.*.apiKey через env var $\{COMETAPI_KEY\}. auth-profiles.json потрібен лише якщо ви хочете ротацію облікових даних за профілями між кількома ключами.
5

Перезапустіть і перевірте

Перезапустіть gateway після додавання .env або зміни config провайдера:
openclaw gateway restart
Потім запустіть діагностику:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Успішне налаштування виглядає так:
  • openclaw models status визначає primary model як cometapi-claude/your-claude-model-id без попереджень missing-auth для провайдерів CometAPI
  • openclaw models list --provider cometapi-claude показує список налаштованих моделей
  • openclaw doctor не повідомляє про помилки config або auth для провайдерів CometAPI
Статус моделей OpenClaw, де провайдери CometAPI автентифіковані
6

Перемикайте моделі

# 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
Якщо ви виправляєте зламане старе налаштування, зупиніть gateway, видаліть ~/.openclaw, а потім знову запустіть onboarding перед застосуванням config CometAPI:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Це видалить усі локальні config, сесії, логи, auth state і робочі простори. Потім знову виконайте кроки 3–5.