Перейти к основному содержанию
Anthropic разрабатывает семейство моделей Claude. OpenClaw поддерживает два способа аутентификации:
  • Ключ API — прямой доступ к Anthropic API с оплатой по фактическому использованию (модели anthropic/*)
  • Claude CLI — повторное использование существующего входа Claude Code на том же хосте
Бэкенд Claude CLI в OpenClaw запускает установленный Claude Code CLI в неинтерактивном режиме печати. Текущая документация Anthropic для Claude Code описывает claude -p как использование Agent SDK/программный режим. Обновление поддержки Anthropic от 15 июня 2026 года приостановило объявленное изменение тарификации Agent SDK. Сейчас Anthropic сообщает, что Claude Agent SDK, claude -p и использование сторонними приложениями по-прежнему расходуют лимиты использования подписки. Ранее объявленный ежемесячный кредит Agent SDK недоступен, пока Anthropic пересматривает этот план.Интерактивный Claude Code по-прежнему расходует лимиты плана Claude, в который выполнен вход. Аутентификация по ключу API остается прямой оплатой API по фактическому использованию. Для долговременных хостов Gateway, общей автоматизации и предсказуемых производственных расходов используйте ключ Anthropic API.Перед тем как полагаться на поведение тарификации подписки, проверяйте текущие статьи поддержки Anthropic:

Начало работы

Лучше всего подходит для: стандартного доступа к API и оплаты по фактическому использованию.
1

Получите ключ API

Создайте ключ API в Anthropic Console.
2

Запустите онбординг

openclaw onboard
# choose: Anthropic API key
Или передайте ключ напрямую:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

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

openclaw models list --provider anthropic

Пример конфигурации

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

Значения по умолчанию для рассуждения (Claude Fable 5, 4.8 и 4.6)

anthropic/claude-fable-5 всегда использует адаптивное рассуждение и по умолчанию задает high усилие. Поскольку Anthropic не разрешает отключать рассуждение для этой модели, /think off и /think minimal используют low усилие. OpenClaw также опускает пользовательские значения температуры для запросов Fable 5. Claude Opus 4.8 по умолчанию в OpenClaw оставляет рассуждение выключенным. Когда вы явно включаете адаптивное рассуждение с помощью /think high|xhigh|max, OpenClaw отправляет значения усилия Anthropic для Opus 4.8; модели Claude 4.6 по умолчанию используют adaptive. Переопределяйте для отдельного сообщения с помощью /think:<level> или в параметрах модели:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

Кэширование промптов

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, переопределяет по ключу)
Это позволяет одному агенту сохранять долгоживущий кэш, пока другой агент на той же модели отключает кэширование для всплескового трафика или трафика с низким повторным использованием.
  • Модели 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 onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Внедряется только для прямых запросов к api.anthropic.com. Прокси-маршруты оставляют service_tier без изменений.
  • Явные параметры serviceTier или service_tier переопределяют /fast, когда заданы оба.
  • В аккаунтах без емкости Priority Tier значение service_tier: "auto" может разрешаться в standard.
Встроенный Plugin Anthropic регистрирует понимание изображений и PDF. OpenClaw автоматически разрешает медиа-возможности из настроенной аутентификации Anthropic — дополнительная конфигурация не нужна.
СвойствоЗначение
Модель по умолчаниюclaude-opus-4-8
Поддерживаемый вводИзображения, PDF-документы
Когда изображение или PDF прикреплены к беседе, OpenClaw автоматически направляет их через провайдера понимания медиа Anthropic.
Контекстное окно 1M Anthropic доступно на моделях Claude 4.x с поддержкой GA, таких как Opus 4.8, Opus 4.7, Opus 4.6 и Sonnet 4.6. OpenClaw автоматически задает для этих моделей размер 1M:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
Старые конфигурации могут сохранять params.context1m: true, но OpenClaw больше не отправляет устаревший бета-заголовок context-1m-2025-08-07. Старые записи конфигурации anthropicBeta с этим значением игнорируются при разрешении заголовков запроса, а неподдерживаемые старые модели Claude остаются на своем обычном контекстном окне.params.context1m: true также применяется к бэкенду Claude CLI (claude-cli/*) для подходящих моделей Opus и Sonnet с поддержкой GA, сохраняя контекстное окно среды выполнения для этих CLI-сеансов в соответствии с поведением прямого API.
Требуется доступ к длинному контексту для ваших учетных данных Anthropic. Аутентификация OAuth/токеном подписки сохраняет требуемые бета-заголовки Anthropic, но OpenClaw удаляет устаревший бета-заголовок 1M, если он остается в старой конфигурации.
anthropic/claude-opus-4-8 и его вариант claude-cli по умолчанию имеют окно контекста 1M — params.context1m: true не требуется.

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

Аутентификация токеном Anthropic истекает, и токен может быть отозван. Для новых настроек вместо этого используйте ключ API Anthropic.
Аутентификация Anthropic выполняется для каждого агента — новые агенты не наследуют ключи основного агента. Повторно выполните onboarding для этого агента (или настройте ключ API на хосте Gateway), затем проверьте с помощью openclaw models status.
Запустите openclaw models status, чтобы увидеть, какой профиль аутентификации активен. Повторно выполните onboarding или настройте ключ API для этого пути профиля.
Проверьте auth.unusableProfiles в openclaw models status --json. Периоды ожидания из-за ограничения скорости Anthropic могут быть привязаны к модели, поэтому родственная модель Anthropic все еще может быть доступна. Добавьте еще один профиль Anthropic или дождитесь окончания периода ожидания.
Дополнительная помощь: Устранение неполадок и FAQ.

Связанные материалы

Выбор модели

Выбор провайдеров, ссылок на модели и поведения переключения при сбое.

Бэкенды CLI

Настройка бэкенда Claude CLI и сведения о выполнении.

Кэширование промптов

Как кэширование промптов работает у разных провайдеров.

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

Сведения об аутентификации и правила повторного использования учетных данных.