English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

Anthropic

Anthropic створює сімейство моделей Claude. OpenClaw підтримує два маршрути автентифікації:

  • Ключ API — прямий доступ до Anthropic API з оплатою за використання (моделі anthropic/*)
  • Claude CLI — повторне використання наявного входу Claude CLI на тому самому хості

Початок роботи

Ключ API

Найкраще для: стандартного доступу до API та оплати за використання.

  • Отримайте ключ API

    Створіть ключ API в Anthropic Console.

  • Запустіть onboarding

    openclaw onboard
# choose: Anthropic API key

    Або передайте ключ напряму:

    openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

  • Перевірте, що модель доступна

    openclaw models list --provider anthropic

    • Приклад конфігурації

    {
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

    Claude CLI

    Найкраще для: повторного використання наявного входу Claude CLI без окремого ключа API.

  • Переконайтеся, що Claude CLI встановлено й виконано вхід

    Перевірте за допомогою:

    claude --version

  • Запустіть onboarding

    openclaw onboard
# choose: Claude CLI

    OpenClaw виявляє та повторно використовує наявні облікові дані Claude CLI.

  • Перевірте, що модель доступна

    openclaw models list --provider anthropic

    • Приклад конфігурації

    Надавайте перевагу канонічному посиланню на модель Anthropic плюс перевизначенню середовища виконання CLI:

    {
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      agentRuntime: { id: "claude-cli" },
    },
  },
}

    Застарілі посилання на моделі claude-cli/claude-opus-4-7 все ще працюють для сумісності, але нова конфігурація має зберігати вибір провайдера/моделі як anthropic/* і розміщувати бекенд виконання в agentRuntime.id.

    Типові налаштування мислення (Claude 4.6)

    Моделі Claude 4.6 в OpenClaw типово використовують мислення adaptive, якщо явний рівень мислення не задано.

    Перевизначте для окремого повідомлення за допомогою /think:<level> або в параметрах моделі:

    {
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}

    Кешування промптів

    OpenClaw підтримує функцію кешування промптів Anthropic для автентифікації за ключем API.

    Значення Тривалість кешу Опис
    "short" (типово) 5 хвилин Застосовується автоматично для автентифікації за ключем API
    "long" 1 година Розширений кеш
    "none" Без кешування Вимкнути кешування промптів 
    {
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
    Перевизначення кешу для окремого агента

    Використовуйте параметри рівня моделі як базову лінію, а потім перевизначайте конкретних агентів через agents.list[].params:

    {
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } },
    ],
  },
}

    Порядок об’єднання конфігурації:

    1. agents.defaults.models["provider/model"].params
    2. agents.list[].params (відповідний id, перевизначення за ключем)

    Це дає змогу одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для нерівномірного трафіку або трафіку з низьким повторним використанням.

    Примітки щодо Bedrock Claude
    • Моделі Anthropic Claude на Bedrock (amazon-bedrock/*anthropic.claude*) приймають наскрізну передачу cacheRetention, якщо її налаштовано.
    • Для моделей Bedrock, що не належать Anthropic, під час виконання примусово встановлюється cacheRetention: "none".
    • Розумні типові значення для ключа API також задають cacheRetention: "short" для посилань Claude-on-Bedrock, якщо явне значення не встановлено.

    Розширена конфігурація

    Швидкий режим

    Спільний перемикач /fast OpenClaw підтримує прямий трафік Anthropic (ключ API та OAuth до api.anthropic.com).

    Команда Відповідає
    /fast on service_tier: "auto"
    /fast off service_tier: "standard_only" 
    {
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
    Розуміння медіа (зображення та PDF)

    Вбудований Anthropic Plugin реєструє розуміння зображень і PDF. OpenClaw автоматично визначає медійні можливості з налаштованої автентифікації Anthropic — додаткова конфігурація не потрібна.

    Властивість Значення
    Типова модель claude-opus-4-6
    Підтримуване введення Зображення, PDF-документи

    Коли до розмови додано зображення або PDF, OpenClaw автоматично маршрутизує його через провайдера розуміння медіа Anthropic.

    Контекстне вікно 1M (бета)

    Контекстне вікно 1M Anthropic обмежене бета-доступом. Увімкніть його для кожної моделі:

    {
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

    OpenClaw зіставляє це з anthropic-beta: context-1m-2025-08-07 у запитах.

    params.context1m: true також застосовується до бекенда Claude CLI (claude-cli/*) для придатних моделей Opus і Sonnet, розширюючи контекстне вікно виконання для цих CLI-сеансів, щоб воно відповідало поведінці прямого API.

    Контекст Claude Opus 4.7 1M

    anthropic/claude-opus-4.7 і його варіант claude-cli мають контекстне вікно 1M типово — params.context1m: true не потрібен.

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

    Помилки 401 / токен раптово став недійсним

    Автентифікація токеном Anthropic завершується й може бути відкликана. Для нових налаштувань використовуйте натомість ключ Anthropic API.

    Не знайдено ключ API для провайдера "anthropic"

    Автентифікація Anthropic є окремою для кожного агента — нові агенти не успадковують ключі головного агента. Повторно запустіть onboarding для цього агента (або налаштуйте ключ API на хості Gateway), потім перевірте за допомогою openclaw models status.

    Не знайдено облікових даних для профілю "anthropic:default"

    Запустіть openclaw models status, щоб побачити, який профіль автентифікації активний. Повторно запустіть onboarding або налаштуйте ключ API для цього шляху профілю.

    Немає доступного профілю автентифікації (усі на паузі відновлення)

    Перевірте openclaw models status --json для auth.unusableProfiles. Паузи відновлення через обмеження частоти Anthropic можуть бути прив’язані до моделі, тому споріднена модель Anthropic все ще може бути придатною для використання. Додайте інший профіль Anthropic або дочекайтеся завершення паузи.

    Пов’язане

    Вибір моделі

    Вибір провайдерів, посилань на моделі та поведінки failover.
    Бекенди CLI

    Налаштування бекенда Claude CLI і деталі виконання.
    Кешування промптів

    Як кешування промптів працює між провайдерами.
    OAuth і автентифікація

    Деталі автентифікації та правила повторного використання облікових даних.