Подключение OpenClaw

Сложность ⌨️ Продвинутый　|　Формат интерфейса Совместимый с OpenAI　|　base_url https://byesu.com/v1

Данные подключения

Адрес APIhttps://byesu.com/v1

Ключ APIsk-xxxxxxxxСоздать в консоли →

Модельgpt-5.5

Формат API OpenAI совместимо · имена моделей — по консоли

OpenClaw (🦞) — это персональный ИИ-ассистент с открытым исходным кодом, который поддерживает настраиваемых поставщиков моделей. Просто укажите ему на Byesu — и всё готово, одинаково для Windows / macOS / Linux.

Перед началом

Сначала перейдите в Консоль → Токены и создайте токен (см. Выбор группы).

Способ 1: мастер настройки (самый простой)

После установки запустите встроенный мастер и по подсказкам выберите поставщика «Свой / Совместимый с OpenAI»:

openclaw onboard

Заполните по порядку:

• Адрес интерфейса / baseUrl: https://byesu.com/v1
• API key: ваш sk-xxxx
• Модель: укажите имя модели из Byesu (например, gpt-5.5, claude-opus-4-8)

Способ 2: ручное редактирование конфигурационного файла

В конфигурационном файле OpenClaw (~/.openclaw/openclaw.json, формат JSON5) в разделе models.providers добавьте своего поставщика:

{
  agents: {
    defaults: { model: { primary: "byesu/gpt-5.5" } },   // 默认用哪个模型
  },
  models: {
    mode: "merge",                   // 合并内置服务商，而非覆盖
    providers: {
      byesu: {
        baseUrl: "https://byesu.com/v1",
        apiKey: "${BYESU_API_KEY}",      // 建议用环境变量，避免明文
        api: "openai-completions",       // OpenAI 兼容
        models: [
          { id: "gpt-5.5", name: "Byesu GPT-5.5" },
          { id: "claude-opus-4-8", name: "Byesu Claude Opus 4.8" },
        ],
      },
    },
  },
}

Несколько важных моментов

• baseUrl указывается с /v1 (совместимость с OpenAI).
• Для apiKey рекомендуется использовать переменную окружения ${BYESU_API_KEY} (храните настоящий ключ в переменной окружения), не коммитьте его в git открытым текстом: export BYESU_API_KEY="sk-xxxx".
• Если Gateway работает как фоновый сервис / демон, убедитесь, что эта переменная есть и в окружении самого процесса сервиса (export только в текущем терминале он не увидит — получите ошибку 401); если вы работаете только локально и конфигурация не попадает в git, ключ можно вписать в неё и открытым текстом.
• Значения id в разделе models должны совпадать с именами моделей в Консоли.
• Точный путь к конфигурационному файлу определяется тем, что сгенерировал мастер openclaw onboard (в некоторых версиях он находится в ~/.config/openclaw/).

Проверка подключения

openclaw models list     # убедитесь, что модели с префиксом byesu/ появились в списке доступных

Можно также выполнить openclaw dashboard, открыть UI и отправить тестовое сообщение.

Застряли?

Если ошибка непонятна, сначала запустите шлюз на переднем плане командой openclaw gateway --port 18789 и наблюдайте за логами и сообщениями об ошибках напрямую.

• 401 / токен недействителен → ключ введён неверно, либо фоновый сервис не видит переменную окружения BYESU_API_KEY (см. важные моменты выше) (подробнее)
• Нет доступного канала → модель не входит в группу вашего токена (Выбор группы, подробнее)
• Остальное см. в Частые ошибки и решения