Використання OpenClaw з CometAPI

Використовуйте CometAPI як постачальника model для OpenClaw — понад 500 моделей в одному API.

Передумови

Node.js ≥ 22 — рекомендовано через nvm
Обліковий запис CometAPI з активним API key — отримайте його тут

Встановлення

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

Увійдіть до консолі CometAPI. Натисніть Add API Key і скопіюйте свій CometAPI API key.

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

Рекомендовано — використовуйте офіційний інсталятор:

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

Або встановіть через npm:

npm install -g openclaw@latest

Потім один раз запустіть майстер налаштування:

openclaw onboard --install-daemon

Під час початкового налаштування виберіть Skip на кроці Model/Auth, якщо хочете налаштувати CometAPI вручну. Після завершення початкового налаштування переконайтеся, що gateway запущено:

openclaw gateway status
openclaw dashboard

Конфігурація

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

Запишіть свій ключ у ~/.openclaw/.env, щоб він був доступний демону без жорсткого кодування у файлах конфігурації:

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

Якщо ви вже передаєте COMETAPI_KEY через свою оболонку, менеджер сервісів або процес роботи із секретами, пропустіть цей крок — конфігурація нижче використовує $\{COMETAPI_KEY\} незалежно від того, як саме задано цю змінну.

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

CometAPI підтримує чотири формати API. Додайте один або кілька блоків провайдерів до ~/.openclaw/openclaw.json:

Provider	API Format	Endpoint called	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" }]
      }
    }
  }
}

Ви можете залишити лише ті провайдери, які вам потрібні, або зберегти всі чотири, щоб маршрутизувати між форматами за допомогою посилань provider/model.Замініть кожен заповнювач your-...-model-id на актуальний model ID зі сторінки моделей CometAPI, який відповідає блоку провайдера.

Використовуйте 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 через змінну середовища $\{COMETAPI_KEY\}. auth-profiles.json потрібен лише в тому разі, якщо ви хочете ротацію облікових даних на рівні профілів між кількома ключами.

Перевірка

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

Перезапустіть gateway після додавання .env або зміни конфігурації provider:

openclaw gateway restart

Потім запустіть діагностику:

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

Успішне налаштування виглядає так:

openclaw models status визначає основну model як cometapi-claude/your-claude-model-id без попереджень про відсутню auth для provider CometAPI
openclaw models list --provider cometapi-claude показує список налаштованих model
openclaw doctor не повідомляє про помилки config або auth для provider CometAPI

Статус моделей OpenClaw показує, що provider CometAPI автентифіковані

Перемикання model

# 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 перед застосуванням конфігурації CometAPI:

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

Це видаляє всю локальну конфігурацію, сесії, логи, стан автентифікації та робочі простори. Потім знову виконайте кроки 3–5.

Огляд

AI агенти для програмування

AI-агенти

AI чат-клієнти

Переклад і мова

Платформи автоматизації

Спостережуваність та оцінювання

AI фреймворки

Використання OpenClaw з CometAPI

Передумови

Встановлення

Конфігурація

Перевірка

Перемикання model

Усунення несправностей

​Передумови

​Встановлення

​Конфігурація

​Перевірка

​Перемикання model

​Усунення несправностей

Передумови

Встановлення

Конфігурація

Перевірка

Перемикання model

Усунення несправностей