Перейти к основному содержанию

OpenClaw: полное руководство по API, настройке и оптимизации (2026)

A
24 мин чтенияOpenClaw

OpenClaw — платформа AI-агентов с открытым кодом и более чем 250K звёзд на GitHub, однако пользователи из Китая сталкиваются с проблемой недоступности API. В этом руководстве представлено сравнение трёх вариантов проксирования, готовые шаблоны конфигурации openclaw.json, рекомендации по выбору моделей для разных сценариев и стратегии контроля ежемесячных расходов — всё для полной настройки за 3 минуты.

OpenClaw: полное руководство по API, настройке и оптимизации (2026)

OpenClaw — самая популярная на сегодняшний день платформа AI-агентов с открытым исходным кодом. Проект набрал более 250 тысяч звёзд на GitHub (март 2026, Yahoo Finance) и позволяет развернуть на собственном компьютере или сервере полноценного AI-помощника, который действительно «работает»: отправляет и читает почту, управляет календарём, пишет код, управляет браузером и даже может быть подключён к мессенджерам вроде Feishu и DingTalk. Однако для пользователей из Китая главная проблема заключается не в установке, а в том, что API таких провайдеров, как OpenAI, Anthropic и Google, недоступны напрямую. В этой статье мы пошагово покажем, как решить эту проблему с помощью API-прокси, а также предоставим готовые шаблоны конфигурации, рекомендации по выбору моделей и стратегии контроля расходов.

Краткое содержание

  • OpenClaw полностью бесплатен (лицензия MIT с открытым кодом), единственная статья расходов — оплата API-вызовов к AI-моделям
  • Основная проблема для пользователей из Китая — недоступность API, для решения которой необходим прокси-сервис
  • Рекомендуется использовать API-прокси (например, laozhang.ai): для настройки достаточно изменить лишь два параметра — baseUrl и apiKey
  • Ежемесячные расходы: лёгкое использование — около $5–8, среднее — около $15–25, интенсивное — около $40–80
  • Комбинирование китайских моделей (DeepSeek/Qwen) и зарубежных (GPT/Claude) позволяет сэкономить 40–60% затрат

Что такое OpenClaw: платформа AI-агентов с 250 тысячами звёзд

OpenClaw (ранее известный как Clawdbot, выпущен Питером Стайнбергером в ноябре 2025 года) — это платформа AI-агентов с открытым исходным кодом, работающая на вашем собственном устройстве. В отличие от онлайн-чатов вроде ChatGPT, OpenClaw не просто «отвечает на вопросы» — он способен самостоятельно выполнять задачи, работая как настоящий цифровой помощник. Его можно представить как AI, управляющий вашим компьютером: он умеет читать и записывать файлы, выполнять команды в терминале, обрабатывать электронную почту, управлять календарём, просматривать веб-страницы, собирать данные и даже самостоятельно писать и запускать код.

По состоянию на март 2026 года OpenClaw стал одним из самых популярных проектов на GitHub, обогнав React по количеству звёзд (около 250K Star, источник: Yahoo Finance, 2026-03-04), и насчитывает более 600 контрибьюторов. Такой стремительный рост неслучаен — OpenClaw решает реальную проблему: он даёт обычным пользователям возможность получить настраиваемого, контролируемого и приватного AI-помощника, данные которого не покидают ваше устройство.

Ядро архитектуры OpenClaw включает пять ключевых компонентов. Gateway — это точка входа в систему, отвечающая за управление сессиями и аутентификацию; по умолчанию работает на порту 18789. Agent — «мозг» системы, который решает, какие инструменты вызвать для выполнения вашей команды. Skills — набор инструментов, аналог системы плагинов; сообщество уже предоставило более 200 устанавливаемых навыков. Channels отвечают за подключение к различным платформам обмена сообщениями — поддерживаются WhatsApp, Telegram, Discord, Slack, Feishu, DingTalk и корпоративный WeChat. Nodes — исполнительные модули, работающие на вашем устройстве и выполняющие непосредственные действия. Главное отличие OpenClaw от инструментов вроде Claude Code заключается в его платформенной независимости — вы можете подключить любую AI-модель (OpenAI, Anthropic, Google, DeepSeek и другие), не привязываясь к одному вендору.

Основная проблема: зачем нужен API-прокси

Схема архитектуры API-прокси OpenClaw, показывающая полный маршрут доступа пользователей из Китая к зарубежным AI-моделям через прокси-сервис

OpenClaw сам по себе — всего лишь программа, запущенная на вашем устройстве; AI-модели в него не встроены. Чтобы он действительно стал «умным», необходимо подключить внешние API AI-моделей — например, GPT-4o от OpenAI, Claude от Anthropic или Gemini от Google. Проблема в том, что серверы этих API расположены за рубежом, и из китайских сетей прямой доступ к ним невозможен.

Конкретнее: когда ваш OpenClaw пытается обратиться к api.openai.com или api.anthropic.com, запрос блокируется сетевыми ограничениями, и вы получаете ошибку тайм-аута соединения. Это не баг OpenClaw, а объективное ограничение сетевой инфраструктуры. Многие начинающие пользователи, установив OpenClaw, обнаруживают, что он ничего не делает, — причина именно в этом.

Принцип работы API-прокси предельно прост: между пользователем в Китае и зарубежным API устанавливается «мост». Ваш OpenClaw отправляет запросы на доступный в Китае адрес прокси-сервиса (например, api.laozhang.ai/v1), тот перенаправляет запросы на реальные серверы OpenAI/Anthropic/Google, получает ответ и возвращает его вам. Весь процесс прозрачен для OpenClaw — он «думает», что обращается напрямую к официальному API, хотя на самом деле между ними есть промежуточный слой. Настройка также предельно проста: достаточно изменить два параметра в openclaw.jsonbaseUrl (адрес API) и apiKey (ключ прокси-платформы).

Разумеется, проксирование — не единственный вариант. Если у вас есть кредитная карта и зарубежный сервер или VPN, можно использовать официальный API напрямую. А если ваши задачи связаны преимущественно с китайским языком, можно подключить отечественные модели — DeepSeek, Qwen и другие, — их API доступны в Китае напрямую и стоят дешевле. Подробное сравнение трёх вариантов приведено далее.

Установка за 3 минуты и базовая настройка

Процесс установки OpenClaw максимально автоматизирован для всех основных операционных систем. Ключевое условие — наличие Node.js версии 22.12.0 или выше. Если Node.js ещё не установлен, скачайте установочный пакет для вашей ОС с официального сайта Node.js.

Для установки OpenClaw достаточно одной команды. Пользователи macOS и Linux выполняют в терминале curl -fsSL https://openclaw.ai/install.sh | bash, пользователи Windows — в PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex. После установки выполните openclaw --version, чтобы убедиться, что версия отображается корректно. По состоянию на март 2026 года последняя стабильная версия — 2026.3.2 (источник: GitHub Releases).

После установки запустите openclaw onboard для запуска мастера начальной настройки. Мастер в интерактивном режиме проведёт вас через базовую конфигурацию. Начинающим рекомендуется выбрать режим QuickStart — он использует порт 18789 по умолчанию и привязку к адресу 127.0.0.1; остальные расширенные параметры (AI-модели, каналы обмена сообщениями, Skills и т. д.) можно пока пропустить — удобнее настроить всё позже через конфигурационный файл.

По завершении мастера на экране появится важная информация, которую обязательно нужно сохранить. Самое главное — ссылка на веб-интерфейс с токеном в формате http://127.0.0.1:18789/#token=ваш_уникальный_токен. При последующем открытии консоли необходимо использовать именно эту ссылку, иначе вы получите ошибку «token_missing» или «authentication failed». Если вы забыли ссылку, выполните openclaw dashboard — браузер откроется автоматически.

Далее следует настройка шлюза (Gateway) — это ключевой шаг для постоянной работы OpenClaw. Простейший способ — выполнить в терминале openclaw gateway и оставить процесс работающим (при закрытии окна сервис останавливается). Для длительного использования или автозапуска при загрузке системы выполните от имени администратора openclaw gateway install для установки демона, затем openclaw gateway start для запуска фонового сервиса. Проверить статус можно командой openclaw status.

После установки наступает самый важный этап — настройка подключения к API AI-моделей. Основной конфигурационный файл OpenClaw — openclaw.json, расположенный по пути ~/.openclaw/openclaw.json (macOS/Linux) или C:\Users\ваше_имя\.openclaw\openclaw.json (Windows). В следующем разделе приведены готовые шаблоны конфигурации.

Выбор варианта API-подключения: какой подходит именно вам

Многомерное сравнение трёх вариантов API-подключения OpenClaw: прокси-сервис, прямое подключение через VPN и отечественные модели

Для подключения AI-моделей к OpenClaw из Китая существуют три основных варианта. Каждый имеет свои преимущества и подходит для разных категорий пользователей и сценариев использования. Здесь мы не составляем субъективный рейтинг, а объективно сравниваем варианты по четырём параметрам: стабильность, охват моделей, сложность настройки и стоимость — чтобы вы выбрали наиболее подходящий вариант.

Вариант 1: API-прокси

Это наиболее распространённый подход среди пользователей OpenClaw в Китае. API-прокси разворачивает доступные в Китае серверы и перенаправляет ваши запросы к зарубежным API AI-моделей — вам нужно лишь изменить baseUrl в openclaw.json на адрес прокси. Например, laozhang.ai поддерживает протоколы OpenAI, Anthropic и Gemini, покрывает более 200 AI-моделей, обеспечивает прямое подключение из Китая, оплату через Alipay/WeChat и тарификацию по использованию без абонентской платы. Пример конфигурации:

json
{ "models": { "providers": [ { "name": "laozhang-relay", "type": "openai", "config": { "baseUrl": "https://api.laozhang.ai/v1", "apiKey": "ваш API Key от laozhang.ai" } } ], "defaults": { "completion": "gpt-4o-mini", "embedding": "text-embedding-3-small" } }, "agents": { "defaults": { "model": "gpt-4o-mini", "provider": "laozhang-relay" } } }

Главное преимущество прокси-варианта — нулевой порог входа: не нужна кредитная карта, зарубежный номер телефона или VPN. Однократная настройка открывает доступ ко всем основным моделям — GPT-4o, Claude Opus 4.6, Gemini 3.1 Pro и другим. Более подробные инструкции по подключению можно найти в руководстве по настройке OpenClaw с laozhang.ai.

Вариант 2: прямое подключение к официальному API + VPN/зарубежный сервер

Если у вас есть зарубежная кредитная карта (Visa/Mastercard) и иностранный номер телефона, вы можете зарегистрировать API Key непосредственно на сайтах OpenAI и Anthropic, а затем запустить OpenClaw через VPN или на зарубежном сервере. Преимущество — официальные цены и прямое подключение без промежуточного слоя. Но есть и существенные минусы: высокий порог регистрации, нестабильность VPN и необходимость управления API Key нескольких платформ одновременно. Подходит для опытных разработчиков, уже имеющих средства для зарубежных платежей.

Вариант 3: прямое подключение к отечественным моделям

API отечественных больших языковых моделей — DeepSeek, Alibaba Qwen, Zhipu GLM и других — доступны в Китае напрямую, без какого-либо проксирования. OpenClaw нативно поддерживает модели, совместимые с протоколом OpenAI, поэтому подключение отечественных моделей очень простое — достаточно заменить baseUrl на адрес API соответствующей модели. Пример конфигурации DeepSeek:

json
{ "name": "deepseek", "type": "openai", "config": { "baseUrl": "https://api.deepseek.com/v1", "apiKey": "ваш DeepSeek API Key" } }

Преимущества отечественных моделей — крайне низкая стоимость (DeepSeek V3.2: ввод всего $0,28/M токенов, источник: deepseek.com, 2026-03-15) и отличное понимание китайского языка. Однако в задачах генерации кода и сложных рассуждений они пока уступают GPT-4o и Claude Opus 4.6. Лучшая практика — комбинировать отечественные и зарубежные модели: для повседневных диалогов использовать DeepSeek, а для сложных задач программирования переключаться на GPT-4o или Claude.

Параметр сравненияAPI-проксиПрямое + VPNОтечественные модели
Сложность настройкиИзменить 2 параметраРегистрация + VPNИзменить 2 параметра
Охват моделей200+ моделейМодели одной платформы5–10
Способ оплатыAlipay/WeChatКредитная картаAlipay/WeChat
Стабильность сетиВысокаяЗависит от VPNОчень высокая
Ежемесячные расходы$5–80$8–90$1–25
Безопасность данныхЧерез прокси-слойПрямое подключениеПрямое подключение

Руководство по выбору моделей: лучший вариант для каждого сценария

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

Повседневные диалоги и информационные запросы: рекомендуется GPT-4o-mini ($0,15/M ввод, источник: openai.com, 2026-03-15) или DeepSeek V3.2 ($0,28/M ввод). Обе модели отлично справляются с обычными вопросами, систематизацией информации и составлением документов при минимальных затратах. Если вы преимущественно работаете с китайским языком, DeepSeek V3.2 в понимании и генерации китайского текста превосходит даже GPT-4o-mini.

Программирование и генерация кода: это наиболее востребованный сценарий использования OpenClaw. Рекомендуются Claude Opus 4.6 ($5,00/M ввод, $25,00/M вывод, источник: platform.claude.com, 2026-03-15) или GPT-4o ($2,50/M ввод, $10,00/M вывод). Claude отлично работает с длинными контекстами и рефакторингом кода, особенно когда необходимо анализировать целый репозиторий. Для более простых задач — автодополнение кода и исправление ошибок — Claude Sonnet 4.6 ($3,00/M ввод) предлагает лучшее соотношение цены и качества.

Сложные рассуждения и анализ: для задач с многошаговой логикой, математическими вычислениями или анализом данных рекомендуются DeepSeek R1 ($0,50/M ввод, $2,18/M вывод) или Gemini 2.5 Pro ($1,25/M ввод, $10,00/M вывод, источник: ai.google.dev, 2026-03-15). Возможности рассуждения DeepSeek R1 приближаются к GPT-4o, но при стоимости в пять раз ниже — отличный выбор при ограниченном бюджете.

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

Контроль расходов: сколько стоит тратить в месяц

Столбчатая диаграмма ежемесячных расходов на OpenClaw: сравнение трёх вариантов для лёгкого, среднего и интенсивного использования

OpenClaw — полностью бесплатное программное обеспечение с открытым исходным кодом (лицензия MIT), никакие сборы не взимаются. Оплачивать нужно лишь две составляющие: вызовы API AI-моделей и, при развёртывании в облаке, хостинг сервера. Пользователи, работающие локально (запуск OpenClaw на собственном компьютере), несут только расходы на API.

Для пользователей API-прокси ежемесячные расходы можно разделить на три уровня. Лёгкое использование (10–20 диалогов в день, в основном простые вопросы и поиск информации) — около $3–8 в месяц (примерно 20–55 юаней). Среднее использование (50–100 диалогов в день, включая помощь в программировании и обработку документов) — около $15–25 в месяц (примерно 100–175 юаней). Интенсивное использование (200+ диалогов в день, массовая генерация кода и сложные задачи) — около $40–80 в месяц (примерно 280–560 юаней). Эти данные основаны на типичном сценарии комбинированного использования GPT-4o-mini (для лёгких задач) и GPT-4o/Claude (для ресурсоёмких задач).

Наиболее эффективная стратегия экономии — маршрутизация между моделями. Суть подхода: в openclaw.json настраивается несколько провайдеров, повседневные диалоги направляются на более дешёвые модели (например, DeepSeek V3.2 или GPT-4o-mini), а переключение на GPT-4o или Claude Opus 4.6 производится вручную только при необходимости высококачественного вывода. OpenClaw позволяет переключать модели непосредственно в диалоге с помощью команд или назначать разные модели для разных типов задач в конфигурации агента. При использовании такой комбинированной стратегии большинство пользователей могут снизить ежемесячные расходы на 40–60% без потери качества результатов.

Ещё один важный момент — выбор модели эмбеддингов (embedding). Функция поиска по памяти OpenClaw использует текстовые эмбеддинги, и при обращении к удалённому API (например, OpenAI text-embedding-3-small) каждый запрос порождает небольшие расходы. Экономичное решение — установить в openclaw.json параметр memorySearch.provider в значение "local" для использования локальных эмбеддингов вместо удалённого API. Качество немного ниже, зато совершенно бесплатно. Подробнее о управлении токенами и оптимизации расходов читайте в статье: Управление токенами и оптимизация расходов в OpenClaw.

Продвинутый уровень: подключение Feishu, DingTalk и корпоративного WeChat

Поддержка основных китайских мессенджеров — важная причина стремительного роста OpenClaw на китайском рынке. С помощью механизма Channels вы можете подключить OpenClaw к Feishu, DingTalk и корпоративному WeChat, общаясь с AI-помощником непосредственно на этих платформах — отправляя команды и получая «управление через чат».

Подключение Feishu на данный момент является наиболее зрелым вариантом. Сообщество OpenClaw выпустило официальный плагин для Feishu; процесс установки очень прост: создайте бот-приложение на платформе Feishu Open Platform, получите App ID и App Secret, затем в веб-консоли OpenClaw перейдите в настройки Channels, выберите канал Feishu и введите учётные данные. Весь процесс занимает около 10 минут и не требует написания кода. После настройки вы сможете взаимодействовать с OpenClaw в Feishu через личные или групповые чаты — отправляйте текстовые команды, и система выполнит соответствующие операции на вашем сервере, вернув результат в окно чата.

Подключение DingTalk и корпоративного WeChat организовано аналогично — через фреймворки ботов соответствующих платформ. Docker-образ от сообщества OpenClaw-Docker-CN-IM уже содержит предустановленные плагины для Feishu, DingTalk, QQ-бота и корпоративного WeChat — если вы не хотите настраивать всё вручную, использование этого образа сэкономит массу времени. Стоит отметить, что в марте 2026 года команда OpenClaw также выпустила нативную поддержку корпоративного WeChat, что ознаменовало более полный охват экосистемы китайских мессенджеров.

Независимо от выбранной платформы, важно помнить о безопасности: канал мессенджера по сути является точкой удалённого управления, и любое сообщение, отправленное боту, может быть выполнено как системная команда. Поэтому обязательно ограничьте права на выполнение команд в настройках безопасности OpenClaw и рекомендуется провести глубокий аудит безопасности командой openclaw security audit --deep, чтобы убедиться в отсутствии критических уязвимостей.

Частые проблемы и устранение неполадок

В процессе использования OpenClaw пользователи из Китая чаще всего сталкиваются с проблемами, связанными с сетевым подключением, форматом конфигурации и правами доступа. Ниже собраны наиболее частые ошибки и их решения для быстрой диагностики и устранения неполадок.

«Gateway service install failed» или «schtasks create failed»: самая распространённая проблема у пользователей Windows, причина практически всегда — отсутствие прав администратора. Решение: закройте текущий терминал, щёлкните правой кнопкой по PowerShell и выберите «Запуск от имени администратора», затем повторно выполните openclaw gateway install и openclaw gateway start.

API-вызов возвращает ошибку тайм-аута или ECONNREFUSED: это означает, что OpenClaw не может подключиться к указанному адресу API. При использовании прокси-сервиса проверьте корректность baseUrl (не забудьте суффикс /v1). При использовании официального API убедитесь, что VPN или прокси работают нормально. Для проверки соединения используйте curl -v https://ваш_baseUrl/models.

«token_missing» или «too many failed authentication attempts»: вы забыли использовать ссылку с токеном для открытия веб-консоли. Выполните openclaw dashboard для автоматического открытия правильной ссылки или проверьте поле gateway.auth.token в openclaw.json.

Ошибка 429 Rate Limit Exceeded: частота API-вызовов превысила лимит модели. Прокси-сервисы обычно имеют собственную политику ограничения частоты запросов; при частом появлении ошибки 429 настройте интервал между запросами в OpenClaw или переключитесь на другую модель. Подробное руководство по устранению ошибки 429 смотрите в нашей статье: Решение ошибки 429 Rate Limit в OpenClaw.

Ошибка формата JSON приводит к сбою запуска OpenClaw: openclaw.json должен быть строго валидным JSON. Обратите внимание на следующее: не допускаются завершающие запятые (после последнего свойства не должно быть запятой), все строки должны быть в двойных кавычках, обратные косые черты в путях Windows нужно записывать как \\. Для проверки конфигурационного файла используйте онлайн-валидатор JSON (например, jsonlint.com).

Типичная ошибкаПричинаРешение
Gateway install failedНет прав администратораЗапустить PowerShell от администратора
ECONNREFUSEDАдрес API недоступенПроверить baseUrl, статус VPN
token_missingСсылка без токенаВыполнить openclaw dashboard
429 Rate LimitСлишком частые запросыСнизить частоту или сменить модель
JSON parse errorОшибка формата конфигурацииПроверить через jsonlint
openclaw: command not foundNode.js не настроенУстановить Node.js >= 22.12.0

Итоги и следующие шаги

OpenClaw — мощная платформа AI-агентов, и для пользователей из Китая ключ к успешному использованию заключается в решении проблемы доступа к API. Для большинства пользователей API-прокси — самый простой и эффективный вариант: изменяете два параметра, пополняете счёт — и получаете доступ ко всем основным AI-моделям. Технически продвинутые пользователи также могут выбрать прямое подключение к API или комбинированное использование отечественных моделей, гибко адаптируя решение под свои сценарии и бюджет.

Рекомендуемые следующие шаги: если вы ещё не установили OpenClaw, выполните команду установки прямо сейчас. Если установка завершена, но вы «застряли» на настройке API, скопируйте шаблон openclaw.json из этой статьи, замените API Key и перезапустите Gateway. Для дальнейшего улучшения рабочего процесса подключите Feishu или DingTalk, чтобы AI-помощник стал частью вашей повседневной работы.

Экосистема OpenClaw стремительно развивается — каждую неделю появляются новые Skills и обновления функций. Регулярно обновляйте версию командой openclaw update, чтобы получать новейшие возможности и исправления безопасности. Если у вас возникнут вопросы, официальная документация OpenClaw (docs.openclaw.ai) и GitHub Discussions — лучшие источники помощи.

Поделиться:

laozhang.ai

Один API, все модели ИИ

AI Изображения

Gemini 3 Pro Image

$0.05/изобр.
-80%
AI Видео

Sora 2 · Veo 3.1

$0.15/видео
Async API
AI Чат

GPT · Claude · Gemini

200+ моделей
Офиц. цена
Обслужено 100K+ разработчиков
|@laozhang_cn|$0.1 бонус