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

Скористайтеся цим посібником, щоб підключити OpenClaw до CometAPI. Виберіть один формат API та ідентифікатор моделі для початкового налаштування.

OpenClaw v2026.8.1 також має назву OpenClaw 2.0. Пакет не використовує 2.x як номер версії. Див. анонс OpenClaw 2.0 та примітки до випуску v2026.8.1.

Офіційні матеріали OpenClaw:

Передумови

Node.js 22.22.3+, 24.15+ або 25.9+. Рекомендовано Node 26. Node 23 не підтримується.
Обліковий запис CometAPI з активним API-ключем із панелі керування.
Ідентифікатор моделі з сторінки CometAPI Models.

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

Перше встановлення
Оновлення встановленої версії

Офіційний інсталятор може встановити CLI без запуску початкового налаштування. Це зберігає налаштування моделі як окремий крок.

macOS / Linux / WSL2
Windows PowerShell

Наведена нижче команда запускає офіційний інсталятор:

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

Наведена нижче команда запускає офіційний інсталятор PowerShell:

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Якщо ви самостійно керуєте Node.js і npm, npm 11.16+ та npm 12 підтримують параметр --allow-scripts цей параметр. Наведена нижче команда встановлює OpenClaw без запуску початкового налаштування:

npm install -g openclaw@latest --allow-scripts=openclaw

У npm 11.15 і раніших версіях не вказуйте --allow-scripts=openclaw, оскільки ця версія npm не розпізнає цей параметр.Переконайтеся, що встановлений CLI відповідає мінімальній версії для цього посібника:

openclaw --version

Перейдіть до Налаштування CometAPI. Не запускайте звичайну процедуру початкового налаштування спочатку, оскільки керований процес не показує всі власні API адаптери.

Створіть і перевірте резервну копію перед значним оновленням. Архів може містити API-ключі, стан каналу та дані автентифікації, тому захищайте його так само, як каталог стану OpenClaw.Наведені нижче команди створюють резервну копію та оновлюють OpenClaw:

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

Після оновлення виправте підтримувані міграції та перевірте стан Gateway:

openclaw doctor --fix
openclaw gateway restart
openclaw health

Оновлення зберігає налаштований маршрут моделі. Не повторюйте початкове налаштування якщо не хочете змінити провайдера моделі або його автентифікацію.

Налаштування CometAPI

Використання класичного початкового налаштування

Класичне початкове налаштування є рекомендованим способом першого встановлення для Chat Completions, Responses і Anthropic Messages. Наведена нижче команда відкриває класичне початкове налаштування та встановлює фонову службу:

openclaw onboard --classic --install-daemon

У Model/Auth, виберіть Custom Provider. Потім введіть значення для одного з цих варіантів сумісності:

Формат API	ID постачальника	Варіант сумісності	Базова URL-адреса
Chat Completions	`cometapi-openai`	Сумісний з OpenAI	`https://api.cometapi.com/v1`
Responses	`cometapi-openai-responses`	Сумісний з OpenAI Responses	`https://api.cometapi.com/v1`
Anthropic Messages	`cometapi-claude`	Сумісний з Anthropic	`https://api.cometapi.com`

Введіть відповідний ID постачальника, your-model-id і свій ключ API CometAPI, коли з’явиться запит. Термінальний майстер маскує введення ключа API. Меню класичного Custom Provider не містить адаптера Google Generative AI адаптер. Щоб використовувати цей адаптер, виконайте Налаштування постачальника за допомогою команд config, встановіть основну модель, а потім запустіть класичне початкове налаштування. Виберіть Зберегти наявну конфігурацію моделі коли майстер запропонує цей варіант.

Налаштування постачальника за допомогою команд config

Використовуйте цей спосіб для адаптера Google або для контрольованих змін конфігурації. OpenClaw підтримує JSON5, тому не аналізуйте та не перезаписуйте openclaw.json за допомогою суворого інструмента JSON.

Власний записувач конфігурації OpenClaw перевіряє JSON5, але нормалізує файл до JSON під час запису. Наявні коментарі, кінцеві коми та форматування можуть бути видалені. Перш ніж застосовувати патч, створіть перевірену резервну копію, якщо ці деталі для вас важливі.

Спочатку виведіть активний шлях до конфігурації та перевірте її вміст:

openclaw config file
openclaw config validate

OpenClaw зчитує ключі API постачальника зі змінних середовища процесу або глобального файлу стану .env. Він не довіряє файлу .env у робочій області щодо ключів API постачальника . Глобальний файл — ~/.openclaw/.env, або $OPENCLAW_STATE_DIR/.env коли встановлено OPENCLAW_STATE_DIR. Якщо класичне початкове налаштування зберегло ключ API, пропустіть наступний крок. В іншому разі скористайтеся вкладкою для своєї операційної системи, щоб зберегти ключ API без його відображення .

macOS / Linux / WSL2
Windows PowerShell

Наведені нижче команди атомарно оновлюють COMETAPI_KEY і відхиляють порожнє значення:

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

Наведені нижче команди оновлюють COMETAPI_KEY без його відображення:

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

Перш ніж додавати постачальника, перевірте його цільовий шлях. Замініть ID постачальника в наведеній нижче команді на ID з вибраної вкладки:

openclaw config get models.providers.cometapi-openai --json

Якщо команда повертає налаштованого постачальника, зупиніться, перш ніж застосовувати приклад. config patch об’єднує об’єкти, але замінює масиви. Об’єднайте нову модель у масив моделей постачальника, перш ніж записувати цей масив. Це збереже метадані моделі, користувацькі заголовки та інші налаштування постачальника. Виберіть один формат API. Кожен патч використовує SecretRef на основі змінної середовища, змінює лише цільові шляхи конфігурації та зберігає інші розділи конфігурації без змін.

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

Chat Completions
Responses
Anthropic Messages
Google Generative AI

ID постачальника: cometapi-openai
Адаптер OpenClaw: openai-completions
Базова URL-адреса: https://api.cometapi.com/v1
Посилання на основну модель: cometapi-openai/your-model-id

Створіть cometapi.patch.json5 із цим патчем постачальника:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Перевірте патч, перш ніж OpenClaw запише конфігурацію:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Якщо перевірка успішна, застосуйте той самий патч:

openclaw config patch --file ./cometapi.patch.json5

Якщо основну модель не налаштовано, установіть цю модель як типову:

openclaw models set cometapi-openai/your-model-id

Перевірте конфігурацію постачальника та надішліть мінімальний запит до моделі:

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

Щоб перемкнути активний сеанс чату OpenClaw, виконайте цю команду чату:

/model cometapi-openai/your-model-id

ID постачальника: cometapi-openai-responses
Адаптер OpenClaw: openai-responses
Базова URL-адреса: https://api.cometapi.com/v1
Посилання на основну модель: cometapi-openai-responses/your-model-id

Створіть cometapi.patch.json5 із цим патчем постачальника:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Перевірте патч, перш ніж OpenClaw запише конфігурацію:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Якщо перевірка успішна, застосуйте той самий патч:

openclaw config patch --file ./cometapi.patch.json5

Якщо основну модель не налаштовано, установіть цю модель як типову:

openclaw models set cometapi-openai-responses/your-model-id

Перевірте конфігурацію постачальника та надішліть мінімальний запит до моделі:

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

Щоб перемкнути активний сеанс чату OpenClaw, виконайте цю команду чату:

/model cometapi-openai-responses/your-model-id

ID постачальника: cometapi-claude
Адаптер OpenClaw: anthropic-messages
Базова URL-адреса: https://api.cometapi.com
Посилання на основну модель: cometapi-claude/your-model-id

Створіть cometapi.patch.json5 із цим патчем постачальника:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Перевірте патч, перш ніж OpenClaw запише конфігурацію:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Якщо перевірка успішна, застосуйте той самий патч:

openclaw config patch --file ./cometapi.patch.json5

Якщо основну модель не налаштовано, установіть цю модель як типову:

openclaw models set cometapi-claude/your-model-id

Перевірте конфігурацію постачальника та надішліть мінімальний запит до моделі:

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

Щоб перемкнути активний сеанс чату OpenClaw, виконайте цю команду чату:

/model cometapi-claude/your-model-id

ID постачальника: cometapi-google
Адаптер OpenClaw: google-generative-ai
Базова URL-адреса: https://api.cometapi.com/v1beta
Посилання на основну модель: cometapi-google/your-model-id

Створіть cometapi.patch.json5 із цим патчем постачальника:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Перевірте патч, перш ніж OpenClaw запише конфігурацію:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Якщо перевірка успішна, застосуйте той самий патч:

openclaw config patch --file ./cometapi.patch.json5

Якщо основну модель не налаштовано, установіть цю модель як типову:

openclaw models set cometapi-google/your-model-id

Перевірте конфігурацію постачальника та надішліть мінімальний запит до моделі:

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

Щоб перемкнути активний сеанс чату OpenClaw, виконайте цю команду чату:

/model cometapi-google/your-model-id

Якщо конфігурація вже використовує ID постачальника cometapi-gemini, збережіть цей ID і використовуйте його в посиланнях на моделі та командах. Не перейменовуйте його й не створюйте дубльований постачальник лише для відповідності цьому посібнику.

Список моделей OpenClaw 2026.8.1 із чотирма форматами постачальників CometAPI

Для нового постачальника openclaw config set надає ту саму схему та перевірки SecretRef. Використовуйте --strict-json, --merge і --dry-run перед записом. Наведена нижче альтернатива попередньо переглядає постачальника Chat Completions:

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

Якщо пробний запуск успішний, повторіть команду без --dry-run, щоб зберегти її. Не застосовуйте цей приклад до налаштованого постачальника. Масив models має містити повний об’єднаний список моделей постачальника перед записом.

Відомості про метадані моделі

Мінімальні патчі оголошують лише текстову модель. Додавайте необов’язкові метадані, лише якщо ви перевірили специфікації моделі:

Поле	Ефект
`input`	Оголошує підтримувані модальності введення. Використовуйте `["text", "image"]` лише тоді, коли модель приймає власне введення зображень.
`contextWindow`	Фіксує власну місткість Context Window моделі.
`contextTokens`	Обмежує активний бюджет введення без зміни `contextWindow`.
`maxTokens`	Обмежує вихідні Tokens, які OpenClaw запитує від моделі.

Некоректні значення можуть приховати підтримувані входи, завищити доступний контекст або запитати непідтримуваний розмір вихідних даних. У багаторазово використовуваних прикладах залишайте your-model-id, і використовуйте сторінку моделей CometAPI щоб вибрати ID моделі.

Перевірте повне налаштування

Після змін у файлі конфігурації або глобальному файлі .env перезапустіть Gateway:

openclaw gateway restart

Потім перевірте конфігурацію та стан Gateway:

openclaw config validate
openclaw doctor
openclaw health

Виконайте команди для конкретного провайдера на вибраній вкладці формату API. Список моделей або перевірка стану підтверджує лише конфігурацію. Команда openclaw agent exec надсилає справжній запит до моделі. Переконайтеся, що вона повертає OPENCLAW_OK без невирішеної помилки автентифікації, адаптера або моделі. Якщо OpenClaw повторює запит, зафіксуйте та перевірте кожну спробу, а не вважайте остаточний маркер успіхом з однієї спроби.

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

Відсутній API key

Переконайтеся, що COMETAPI_KEY наявний у середовищі процесу або у файлі глобального стану .env. Не виводьте його значення в термінал.Після виправлення надійного джерела ключа перезапустіть і перевірте Gateway:

openclaw gateway restart
openclaw health

ID провайдера має інші налаштування

Не перезаписуйте провайдера, який має інші baseUrl, api, користувацькі заголовки або метадані моделі. Спочатку перевірте цільового провайдера:

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

Використовуйте інший ID провайдера, якщо обидві конфігурації є навмисними. Якщо відмінність випадкова, створіть перевірену резервну копію, перш ніж змінювати цільового провайдера.

Оновлення не завершилося

Перевірте стан оновлення, перш ніж відновлювати інсталяцію:

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

Ці команди зберігають каталог стану.

Потрібне повернення коду до попередньої версії

Повторно встановіть відому версію пакета, зберігаючи каталог стану. Спочатку перегляньте операцію:

openclaw update --tag 2026.8.1 --dry-run

Якщо попередній перегляд правильний, виконайте ту саму операцію без --dry-run:

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

Відновлюйте резервну копію стану, лише якщо встановлений код не може прочитати стан. Відновлення стану може видалити сеанси та зміни конфігурації, які були створені після створення резервної копії.

Огляд

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

AI-агенти

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

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

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

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

AI фреймворки

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

Передумови

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

Налаштування CometAPI

Використання класичного початкового налаштування

Налаштування постачальника за допомогою команд config

Відомості про метадані моделі

Перевірте повне налаштування

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

​Передумови

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

​Налаштування CometAPI

​Використання класичного початкового налаштування

​Налаштування постачальника за допомогою команд config

​Відомості про метадані моделі

​Перевірте повне налаштування

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

Передумови

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

Налаштування CometAPI

Використання класичного початкового налаштування

Налаштування постачальника за допомогою команд config

Відомості про метадані моделі

Перевірте повне налаштування

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