canonical_url: https://yycode.net/docs/ru/openclaw-quickstart lang: ru updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/ru/openclaw-quickstart # yycode × OpenClaw: руководство быстрого старта ## Сценарий использования Эта статья решает только одну задачу: подключить сервис моделей OpenClaw к yycode и выполнить проверку работоспособности. Если Node.js еще не установлен, сначала смотрите [Руководство по установке окружения Node.js](nodejs-setup). --- ## 1. Подготовка Перед началом проверьте: - Вы уже создали API Key в [консоли yycode](https://yycode.net/console/token) - Вы знаете фактическое имя модели, например `gpt-5.4` (полный список ниже в разделе [поддерживаемых моделей](#支持的模型)) - Ваша среда соответствует официальным требованиям OpenClaw: рекомендуется `Node 24`, совместимо с `Node 22.16+` - Пользователям Windows рекомендуется сначала использовать `WSL2 + Ubuntu` для установки и запуска OpenClaw --- ## Поддерживаемые модели ### OpenAI-совместимые модели | Имя модели | |---| | `gpt-5.4` | | `gpt-5.2` | | `gpt-5.3-codex` | | `gpt-5.2-codex` | | `gpt-5.1-codex-max` | | `gpt-5.1-codex-mini` | ### Anthropic-совместимые модели | Имя модели | |---| | `claude-opus-4-6` | | `claude-sonnet-4-6` | | `claude-haiku-4-5-20251001` | --- ## 2. Рекомендуемый путь: подключение через мастер OpenClaw Если вы хотите сначала просто соединить OpenClaw и yycode, самый простой способ — запустить встроенный мастер OpenClaw; когда браузерная консоль начнет нормально отвечать, можно продолжить настройку каналов или фонового сервиса. ### Шаг 1: установите OpenClaw macOS / Linux / WSL2 могут выполнить официальный скрипт установки напрямую: ```bash # Установить CLI-инструмент openclaw; --no-onboard означает не запускать мастер сразу после установки curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard ``` После установки можно проверить доступность команды: ```bash openclaw --help ``` ### Шаг 2: запустите мастер подключения ```bash openclaw onboard ``` ### Шаг 3: выберите пользовательского провайдера в мастере Когда мастер дойдет до шага модели и авторизации, выберите `Custom provider`, затем заполните значения ниже: | Поле | Значение | |---|---| | Тип совместимости | `Anthropic-compatible` или `OpenAI-compatible` | | Базовый адрес | См. пояснение ниже | | Имя модели | `claude-sonnet-4-6` или `gpt-5.4` (полный список см. в [поддерживаемых моделях](#支持的模型)) | | Provider ID | `yycode` | | API Key | созданный вами yycode API Key | > **Пояснение по базовому адресу:** > - При выборе `Anthropic-compatible` укажите: `https://yycode.net` > - При выборе `OpenAI-compatible` нужно добавить `/v1` в конце: `https://yycode.net/v1` ### Шаг 4: завершите мастер и проверьте При первом подключении порт gateway, способ bind и фоновый сервис можно оставить по умолчанию. После завершения мастера выполните по очереди: ```bash # Проверить корректность формата конфигурации openclaw doctor # Посмотреть текущий статус и загруженные модели openclaw status # Открыть локальную консоль и отправить сообщение для проверки ответа openclaw dashboard ``` Если в консоли сообщение получает ответ модели, подключение успешно. --- ## 3. Скриптовое подключение Если вы хотите встроить инициализацию OpenClaw в скрипт, серверный деплой или корпоративный образ, рекомендуется неинтерактивный режим. ### Шаг 1: экспортируйте API Key ```bash # Сначала запишите yycode API Key в переменную окружения export CUSTOM_API_KEY="YOUR_yycode_API_KEY" ``` ### Шаг 2: выполните неинтерактивную команду подключения ```bash # Неинтерактивное подключение: настроить yycode как пользовательского провайдера openclaw onboard --non-interactive \ --mode local \ --auth-choice custom-api-key \ --custom-base-url "https://yycode.net" \ --custom-model-id "gpt-5.4" \ --custom-provider-id "yycode" \ --custom-compatibility openai \ --secret-input-mode ref \ --gateway-port 18789 \ --gateway-bind loopback ``` ### Шаг 3: подтвердите имя переменной окружения Если вы использовали `--secret-input-mode ref`, текущая версия OpenClaw обычно сохраняет API Key как ссылку на переменную окружения. Рекомендуется прямо использовать `CUSTOM_API_KEY`, как в примере выше, чтобы соответствовать официальной документации по автоматизации. Если конфигурация уже создана, можно открыть `~/.openclaw/openclaw.json` и проверить фактическое имя переменной. Если ваша версия записала другое имя, добавьте соответствующую переменную по фактической конфигурации, например: ```bash export OPENAI_API_KEY="YOUR_yycode_API_KEY" ``` --- ## 4. Ручная проверка или ручная запись конфигурации Если не хотите запускать мастер, можно напрямую проверить или отредактировать `~/.openclaw/openclaw.json`. Ниже пример конфигурации, который можно использовать как ориентир. Замените имя модели и переменную API Key на свои фактические значения: ```json5 { agents: { defaults: { // Модель по умолчанию должна быть в формате "ID провайдера/имя модели", нельзя писать только имя модели model: { primary: "yycode/gpt-5.4" }, }, }, models: { providers: { dragoncode: { baseUrl: "https://yycode.net", // Рекомендуется ссылаться на переменную окружения, чтобы не записывать ключ в конфиг открытым текстом apiKey: "${CUSTOM_API_KEY}", api: "openai-completions", models: [ { // Замените на фактически доступное имя модели в консоли yycode id: "gpt-5.4", name: "gpt-5.4", }, ], }, }, }, } ``` > **Самое частое место ошибки**: модель по умолчанию должна быть `yycode/имя модели`, например `yycode/gpt-5.4`; нельзя писать только `gpt-5.4`. --- ## 5. Критерии успеха Если выполнены пункты ниже, значит подключение в целом работает: - Базовый адрес указан как `https://yycode.net` - API Key все еще действителен: не истек, не отключен, квота не исчерпана - Модель по умолчанию записана как `yycode/ваше имя модели` - `openclaw doctor` и `openclaw status` не сообщают об ошибках конфигурации - Браузерная консоль может нормально отправлять сообщения и получать ответы --- ## 6. Частые вопросы ### Адрес вроде заполнен, но подключиться все равно не получается Сначала проверьте, что базовый адрес именно `https://yycode.net`. Не добавляйте / ### OpenClaw запускается, но при отправке сообщения пишет, что модель не существует Обычно сначала проверяют два пункта: - Является ли указанное имя модели фактическим открытым именем вызова в yycode - Записана ли модель по умолчанию как `yycode/имя модели`, а не только имя модели ### При скриптовой команде пишет, что API Key отсутствует Обычно это означает, что переменная окружения не была реально экспортирована или ее имя не совпадает с тем, что указано в конфигурации OpenClaw. Можно напрямую открыть `~/.openclaw/openclaw.json`, проверить, на какую переменную ссылается поле `apiKey`, и добавить соответствующую переменную в текущий shell. По рекомендуемому пути из этой статьи сначала проверяйте `CUSTOM_API_KEY`. ### OpenClaw уже настроен, почему он еще не работает в WhatsApp или Telegram? Обычно это не проблема подключения модели, а незавершенная настройка канала. Эта страница отвечает только за соединение модельных вызовов между OpenClaw и Dragon Code; настройку каналов продолжайте по [официальной документации OpenClaw Channels](https://docs.openclaw.ai/channels). --- ## 7. Следующий шаг - Еще не создали Key: вернитесь в [консоль yycode](https://yycode.net/console/token) и сначала создайте API Key - Хотите сначала настроить другие инструменты разработки: продолжайте читать [Руководство быстрого старта Claude Code](claude-code-quickstart) и [Руководство быстрого старта Codex](codex-quickstart) - Нужно установить runtime-окружение: смотрите [Руководство по установке окружения Node.js](nodejs-setup) - Столкнулись с частыми проблемами подключения: смотрите [Частые вопросы](faq)