Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​
Установка

1

Get your CometAPI API key

Войдите в консоль CometAPI. Нажмите Add API Key и скопируйте ваш ключ <COMETAPI_KEY>.
Панель управления CometAPI с кнопкой Add API Key
Сведения об API-ключе CometAPI с base URL
2

Install or update 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

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

1

Store your CometAPI key

Запишите ваш ключ в ~/.openclaw/.env, чтобы он был доступен daemon без жесткого указания в конфигурационных файлах:
printf 'COMETAPI_KEY=%s\n' 'your-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Если вы уже передаете COMETAPI_KEY через shell, менеджер сервисов или workflow для секретов, пропустите этот шаг — конфигурация ниже использует $\{COMETAPI_KEY\} независимо от того, как задана переменная.
2

Configure CometAPI providers

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 на актуальный model 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 нужен только в том случае, если вам нужна ротация учетных данных по профилям между несколькими ключами.

​
Проверка

1

Restart and verify

Перезапустите 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, показывающий, что провайдеры CometAPI аутентифицированы

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

1

Switch models

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