Skip to Content
ДокументацияИнтеграцииOpenClaw 🦞

OpenClaw 🦞

OpenClaw  — локальный ИИ-ассистент с открытым исходным кодом, взаимодействующий через мессенджеры WhatsApp, Telegram, Slack и др. Он выполняет реальные действия — управление почтой, календарём, регистрация на рейсы, просмотр веб-страниц и т.д. Полностью работает локально, данные не покидают ваше устройство.

Почему стоит использовать OfoxAI?

  • 100+ моделей через единый API — один API Key для доступа к Claude, GPT, Gemini, Qwen, Doubao и другим ведущим моделям
  • Гибкие стратегии Agent — разные модели для разных агентов: Sonnet для основных задач, Opus для рассуждений, Haiku для лёгких задач
  • 99.9% SLA — мультинодовая избыточность, автоматическое переключение при сбоях
  • Контроль расходов — единая панель биллинга, мониторинг потребления токенов в реальном времени

OpenClaw как агентный ИИ-ассистент потребляет значительное количество токенов за одну задачу (обычно 10K-100K+). Рекомендуется выбирать модель в зависимости от сложности задачи, чтобы избежать лишних затрат. В этой статье приведены три варианта конфигурации.

Установка

macOS / Linux
curl -sSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

Быстрый старт

1. Получение API Key

Перейдите в консоль OfoxAI  и создайте API Key.

2. Запуск мастера настройки

OpenClaw предоставляет интерактивный мастер настройки. Введите следующую команду для быстрой настройки:

openclaw onboard

В мастере выберите Custom Provider и введите следующую информацию:

ПараметрЗначение
Provider Typeanthropic-messages
Base URLhttps://api.ofox.ai/anthropic
API KeyВаш OfoxAI API Key
Modelanthropic/claude-sonnet-4.5

3. Запуск и проверка

openclaw start

Отправьте сообщение OpenClaw для проверки подключения. Если вы получили корректный ответ — настройка завершена успешно.

Мастер автоматически создаст файл конфигурации openclaw.json. Если вам нужен более детальный контроль, обратитесь к полной конфигурации ниже.

Полная конфигурация

OpenClaw управляет всей конфигурацией через ~/.openclaw/openclaw.json (поддерживает формат JSON5 с комментариями).

Настройка Provider

Провайдеры определяются в models.providers. Для каждого провайдера необходимо указать тип API-протокола, адрес и ключ:

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": []
      },
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.ai/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": []
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": []
      }
    }
  }
}

apiKey поддерживает синтаксис ${ENV_VAR} для ссылки на переменные окружения, что позволяет не хранить ключ открытым текстом в файле конфигурации. Три протокола для разных семейств моделей: Claude использует ofoxai-anthropic (anthropic-messages), OpenAI — ofoxai-openai (openai-responses), Gemini — ofoxai-gemini (google-generative-ai). Остальные модели можно подключить через ofoxai-openai.

Настройка Models

Модели определяются в массиве models соответствующего провайдера. Мы предлагаем три варианта конфигурации на выбор:

Полная линейка Claude — максимальные возможности для требовательных сценариев.

openclaw.json — models.providers
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}
МодельРольСценарий применения
anthropic/claude-sonnet-4.5Основная модельПовседневные диалоги, выполнение задач, генерация кода
anthropic/claude-opus-4.6Глубокое рассуждениеСложный анализ, многошаговые рассуждения, исследовательские задачи
anthropic/claude-haiku-4.5Быстрые ответыПростые запросы, быстрые ответы, лёгкие задачи

Настройка Agents

OpenClaw задаёт глобальные значения по умолчанию через agents.defaults и определяет различных агентов через массив agents.list. Каждый агент может переопределить настройки по умолчанию:

openclaw.json — раздел agents
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}
AgentМодельНазначение
mainclaude-sonnet-4.5 (наследует defaults)Агент по умолчанию для всех повседневных задач
researchclaude-opus-4.6Глубокие исследования, сложные рассуждения, анализ длинных текстов
quickclaude-haiku-4.5Простые вопросы, быстрые ответы, низкая стоимость

Формат ссылки на модель: имя-провайдера/model-id (например, ofoxai-anthropic/anthropic/claude-sonnet-4.5). Поле models в defaults определяет псевдонимы моделей для быстрого переключения в диалоге через /model opus. Агенты в list наследуют все настройки из defaults — нужно переопределить только изменяемые поля.

Полный пример конфигурации

Ниже приведён полный файл openclaw.json, объединяющий настройки Provider, Models и Agents (вариант максимальной мощности):

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "models/google/gemini-2.5-flash",
            "name": "Gemini 2.5 Flash",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "models/google/gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}

Сценарии использования

После настройки отправляйте команды OpenClaw через мессенджер:

  • Управление почтой — «Разбери сегодняшние непрочитанные письма и отсортируй по приоритету»
  • Планирование — «Запланируй командное совещание на завтра в 15:00»
  • Поиск информации — «Найди последние технические статьи об AI Agent и составь краткое резюме»
  • Помощь с кодом — «Сделай ревью этого Python-кода, проверь на проблемы безопасности»
  • Автоматизация — «Каждый день в 9:00 отправляй дневной отчёт команды в канал Slack #general»

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

Не удаётся подключиться к OfoxAI

Убедитесь, что baseUrl настроен правильно:

  • Протокол Anthropic: https://api.ofox.ai/anthropic
  • Протокол OpenAI-Response: https://api.ofox.ai/v1
  • Протокол Gemini: https://api.ofox.ai/gemini

Модель не найдена

Убедитесь в правильности формата ID модели. При определении модели в models.providers используйте полный ID, возвращаемый OfoxAI (например, anthropic/claude-sonnet-4.5). При ссылке на модель в agents добавляйте префикс имени провайдера: ofoxai-anthropic/anthropic/claude-sonnet-4.5.

Слишком высокое потребление токенов

OpenClaw потребляет значительное количество токенов за одну задачу. Рекомендации:

  1. Для повседневных задач используйте claude-haiku-4.5 или экономичные модели
  2. Переключайтесь на агент research (с claude-opus-4.6) только для сложных задач
  3. Мониторьте потребление в консоли OfoxAI 

Как быстро переключать модели

Используйте псевдонимы в диалоге: /model opus, /model sonnet, /model haiku (необходимо настроить псевдонимы в agents.defaults.models).

Last updated on
ClineCherry Studio