Использование OpenClaw с CometAPI

Используйте CometAPI как provider моделей для OpenClaw — более 500 моделей в одном API.

Предварительные требования

Node.js ≥ 22 — рекомендуется через nvm
Аккаунт CometAPI с активным API key — получить можно здесь

Установка

Получите ваш CometAPI API key

Войдите в консоль CometAPI. Нажмите Add API Key и скопируйте ваш CometAPI API key.

Панель управления CometAPI с кнопкой Add 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:

Провайдер	Формат API	Вызываемый endpoint	Базовый 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 Models page, соответствующий блоку провайдера.

Используйте 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 или изменения конфигурации провайдера:

openclaw gateway restart

Затем запустите диагностику:

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

Успешная настройка выглядит так:

openclaw models status сопоставляет основную модель с cometapi-claude/your-claude-model-id без предупреждений об отсутствующей аутентификации для провайдеров CometAPI
openclaw models list --provider cometapi-claude выводит список настроенных вами моделей
openclaw doctor не сообщает об ошибках конфигурации или аутентификации для провайдеров CometAPI

OpenClaw models status показывает, что провайдеры CometAPI аутентифицированы

Переключение моделей

# 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

Предварительные требования

Установка

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

Проверка

Переключение моделей

Устранение неполадок

​Предварительные требования

​Установка

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

​Проверка

​Переключение моделей

​Устранение неполадок

Предварительные требования

Установка

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

Проверка

Переключение моделей

Устранение неполадок