Youyun API Youyun API Документы

yycode × OpenClaw: руководство быстрого старта

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

Эта статья решает только одну задачу: подключить сервис моделей OpenClaw к yycode и выполнить проверку работоспособности.

Если Node.js еще не установлен, сначала смотрите Руководство по установке окружения Node.js.

1. Подготовка

Перед началом проверьте:

  • Вы уже создали API Key в консоли yycode
  • Вы знаете фактическое имя модели, например 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 могут выполнить официальный скрипт установки напрямую:

# Установить CLI-инструмент openclaw; --no-onboard означает не запускать мастер сразу после установки
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

После установки можно проверить доступность команды:

openclaw --help

Шаг 2: запустите мастер подключения

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 и фоновый сервис можно оставить по умолчанию. После завершения мастера выполните по очереди:

# Проверить корректность формата конфигурации
openclaw doctor

# Посмотреть текущий статус и загруженные модели
openclaw status

# Открыть локальную консоль и отправить сообщение для проверки ответа
openclaw dashboard

Если в консоли сообщение получает ответ модели, подключение успешно.

3. Скриптовое подключение

Если вы хотите встроить инициализацию OpenClaw в скрипт, серверный деплой или корпоративный образ, рекомендуется неинтерактивный режим.

Шаг 1: экспортируйте API Key

# Сначала запишите yycode API Key в переменную окружения
export CUSTOM_API_KEY="YOUR_yycode_API_KEY"

Шаг 2: выполните неинтерактивную команду подключения

# Неинтерактивное подключение: настроить 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 и проверить фактическое имя переменной. Если ваша версия записала другое имя, добавьте соответствующую переменную по фактической конфигурации, например:

export OPENAI_API_KEY="YOUR_yycode_API_KEY"

4. Ручная проверка или ручная запись конфигурации

Если не хотите запускать мастер, можно напрямую проверить или отредактировать ~/.openclaw/openclaw.json.

Ниже пример конфигурации, который можно использовать как ориентир. Замените имя модели и переменную API Key на свои фактические значения:

{
  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.

7. Следующий шаг

Вся страница скопирована