OpenClaw

Готовые агентыСредний5 мин

OpenClaw подключает Zukko как custom provider. Конфиг: ~/.openclaw/openclaw.json. Ключ: fetch_... (API-ключи).

Вариант	api	baseUrl
OpenAI Compatible	`openai-completions`	`https://api.zukko.pro/v1`
Anthropic Messages	`anthropic-messages`	`https://api.zukko.pro`

1Через onboard

bash

npm install -g openclaw

openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.zukko.pro/v1" \
  --custom-model-id "claude-sonnet-5" \
  --custom-api-key "fetch_..." \
  --secret-input-mode plaintext \
  --custom-compatibility openai

Для варианта Anthropic: --custom-base-url "https://api.zukko.pro" (без /v1) и --custom-compatibility anthropic. Флаги onboard меняются от версии к версии — сверьтесь с openclaw onboard --help.

2Вручную: OpenAI Compatible

Модель custom-провайдера должна быть описана в models.providers.<провайдер>.models[] — иначе OpenClaw о ней не знает.

json5

{
  models: {
    mode: "merge",
    providers: {
      zukko: {
        baseUrl: "https://api.zukko.pro/v1",
        apiKey: "fetch_...",
        api: "openai-completions",
        models: [
          {
            id: "claude-sonnet-5",
            name: "Claude Sonnet 5",
            input: ["text", "image"],
            contextWindow: 1000000,

agents.defaults.models задаёт только короткие имена (alias) и настройки моделей — он ничего не ограничивает.

3Вручную: Anthropic Messages

Тот же файл, но в провайдере:

json5

baseUrl: "https://api.zukko.pro",
api: "anthropic-messages",

Base URL — без /v1.

4Применить и проверить

Gateway подхватывает изменения openclaw.json сам. Если OpenClaw пишет Restart the gateway to apply, перезапустите Gateway. Проверка:

bash

openclaw config validate
openclaw models list

5Если не работает

Модели нет в списке — проверьте, что она описана в models.providers.zukko.models[], а ID совпадает с GET /v1/models.
Модель запрещена — если у вас задан agents.defaults.modelPolicy.allow, добавьте туда zukko/<id> (или zukko/*).
401 — ключ fetch_... и URL по таблице выше (с /v1 или без).
404 `model_not_found` — такой модели нет в каталоге: проверьте имя по GET /v1/models.
503 `model_disabled` — модель временно выключена, возьмите другую из GET /v1/models.

Hermes

Аутентификация